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PREFACE 


This  product  specification  covers  the  work  performed  under 
Air  Force  Contract  F33615-80-C-5155  (ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker,  ICAM  Program  Manager,  Manufacturing  Technology 
Division,  through  Project  Manager,  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Schenectady,  New  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany,  New  York. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 


Subcontractors 

Boeing  Military  Aircraft 
Company  ( BMAC ) 

D.  Appleton  Company 
(DACOM) 


General  Dynamics/ 
Ft.  Worth 


Role 

Reviewer . 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search . 

Responsible  for  factory  view 
function  and  information 
mode 1 s . 
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Subcontractors 

Illinois  Institute  of 
Technology 

North  American  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
SofTech 


I 

i 

Role 


Responsible  for  factory  view 
function  research  (IITRI) 
and  information  models  of 
small  and  medium-size  business. 

Reviewer. 

Responsible  for  factory  view 
function  and  information 
models . 

Responsible  for  IDEF2  support. 
Responsible  for  IDEFO  support. 


TASKS  4.3  -  4.9  (TEST  BED) 
Subcontractors  Role 


Boeing  Military  Aircraft 
Company  (BMAC) 


Computer  Technology 
Associates  (CTA) 


Control  Data  Corporation 
(CDC) 


D.  Appleton  Company 
(DACOM) 


Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  computer  technology. 

Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 

Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DACOM). 

Responsible  for  the  overall  CDM 
Subsystem  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 
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Subcontractors 

Digital  Equipment 
Corporation  (DEC) 


McDonnell  Douglas 
Automation  Company 
(McAuto) 


On-Line  Software 
International  (OSI) 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
became  McCormack  B  Dodge) 


SofTech,  Inc. 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Role 

Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation. 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 

Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Other  prime  contractors  under  other  projects  who  have 
contributed  to  Test  Bed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


J  J 

Contractors 

ICAM  Project 

Contributing  Activities 

*  4 

‘l' 

Boeing  Military 

1701,  2201, 

Enhancements  for  IBM 

t.  V  * 

Aircraft  Company 

2202 

node  use.  Technology 

»■ 

Jl  , 

(BMAC) 

v 

Transfer  to  Integrated 

Sheet  Metal  Center 
(ISMC). 

* 

V  .  1-7  Vi  v  f  *  •  V 

r  ■  -  1  i’  if  *  c  h*  i  *  i*  . 
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Contractors 

ICAM  Project 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1502,  1701 

IISS  enhancements  to 
Common  Data  Model 
Processor  (CDMP) . 

D.  Appleton  Company 
(DAGOM) 

1502 

IISS  enhancements  to 
Integration  Methodology. 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  communications 
equipment . 

Hughes  Aircraft 

Company  (HAC) 

1701 

Test  Bed  enhancements. 

Structural  Dynamics 
Research  Corporation 
(SDRC) 

1502.  1701, 
1703 

IISS  enhancements  to 
User  Interface/Virtual 
Terminal  Interface 
(UI/VTI ) . 

Systran 

1502 

Test  Bed  enhancements. 
Operation  of  Test  Bed. 
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SECTION  1 
SCOPE 


1 . 1  Ident i f i cat i on 


This  specification  establishes  the  design  of  the 
Jr*** Aggregator  Functions'^" one  of  the  major  functions  of  the 
Configuration  Item^Common  Data  Model  Processor  (CDMP)“^to  be 
built  and  formally  accepted  by  the  ICAM  Program  Office.  This  Cl 
constitutes  one  of  the  subsystems  of  the  Common  Data  Model 
Processor  (CDM) . v 


1 .2  Functional  Summary 


t>The  purpose  of  this  Computer  Program  Configuration  Item 
(CPCI)  is  to  aggregate  the  query  output  files  and  produce  the 
result  file  of  the  aggregation.  f  Jrfcr,  /.J 


The  following  functions  are  performed  by  all  three 
aggregators . 


r 


i. 


2. 


•>  / 

/ 


This  CPCI  receives  and  unpacks  a  message  from  the 
Network  Transaction  Manager  and  builds  the  appropriate 
tables  that  contain  the  descriptions  of  the  files  that 
are  to  be  aggregated. 


A  sort  is  performed  on  both  input  files  based  on  the 
key(s)  of  each  file. 


3.  Individual  Aggregator  Functions: 


a.  UNION:  The  Union  Aggregator  does  a  sort/merge  to 
combine  the  two  files  into  the  result  file.  The 
sort/merge  is  based  on  ascending  values  with  a 
compare  between  each  key  in  each  file.  The  result 
file  contains  the  combined  input  files. 

b.  NOT  IN  SET:  The  NIS  Aggregator  compares  the  two 
sorted  input  files  based  on  the  k*ys  and  determines 
if  any  key  value  from  the  first  input  file  is  in 
the  second  input  file.  If  true,  then  the  record 
from  the  first  input  file  is  discarded  and  the 
compare  continues  looking  for  file  1  keys  that  do 
not  match  file  2  keys.  The  results  file  contains 
input  file  1  records  that  do  not  match. 

c.  JOIN:  The  Join  Aggregator  combines  two  sorted 
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input  files  based  on  the  keys  and  determines  if  the 
key  value  from  the  first  input  file  is  equal  to  the 
keys  in  second  input  file.  If  false,  then  the 
record  is  discarded.  If  true,  the  record  is  used 
to  form  the  result  file. 

The  results  of  each  aggregator  are  written  to  a  result 
file  described  in  the  initial  message. 

The  aggregators  send  a  completion  message  to  the  NTH 
containing  the  status  of  the  aggregation,  the  name  of 
the  result  file  and  the  count  of  the  records  in  the 
file. 
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SECTION  2 
DOCUMENTS 


2.1  Reference  Documents 


1.  I CAM  Documentat i on  Standards :  IDS15012000A,  28 

December  1981. 

2.  D.  Appleton  Co.,  CDM  Administrators  Manual; 

UM620 141000,  March  1984. 

3.  D.  Appleton  Co.,  CDM1-IDEF1  Model  of  the  Common  Data 
Model ;  CCS620141000,  15  May  1985. 

4.  D.  Appleton  Co.,  Computer  Program  Development 
Specification  (PS)  f or  I CAM  Integrated  Support  System 
( IISS)  Configuration  Item:  NDML  Precomp i ler ; 
DS620141200,  1984. 

5.  D.  Appleton  Co.,  Embedded  NDML  Programmer ' s  Reference 
Manual;  PRM  620141200,  March  1985. 

6.  Softech,  Inc.,  NTM  Programmer ' s  Guide:  UM620140001 , 
July  1984. 

7.  Control  Data  Corporation,  Computer  Development 
Specification  (PS)  for  I CAM  Integrated  Support  System 
( IISS)  Conf i gurat i on  Item :  NDDL  Command  Processor : 
DS620141 100 ,  June  1985. 

2.2  Terms  and  Abbreviations 


Attribute  Use  Class:  (AUC) 

Conceptual  Schema:  (CS) 

Common  Data  Model  Processor :  ( CDMP ) 

Common  Data  Model :  (CDM)  Describes  common  data  application 
process  formats,  form  definitions,  etc,  of  the  IISS  and  includes 
conceptual  schema,  external,  internal  schemas,  and  schema 
transformation  operators. 

Data  Field:  (DF)  An  element  of  data  in  the  external 
schema.  It  is  by  this  name  that  an  NDML  programmer  references 
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data. 


Database  Management  System:  (DBMS) 

Distributed  Request  Supervisor:  (DRS)  This  IISS  CDM 
subsystem  configuration  item  controls  the  execution  of 
distributed  NDML  queries  and  non  distributed  updates. 

Domain:  A  logical  definition  of  legal  attribute  class 
values . 

Domain  Constraint:  Predicate  that  applies  to  a  single 


domain. 

External  Schema: 

(ES) 

Forms:  Structured  views  which  may  be  imposed  on 
other  forms.  A  form  is  composed  of  fields  where  each 
form,  item,  or  window. 

windows  or 
field  is  a 

Forms  Processor: 
routines  available  to 
processing. 

(FP)  A  set  of  callable  execution  time 
an  application  program  for  form 

Internal  Schema: 

(IS) 

Integrated  Information  Support  System:  (IISS)  A  test 
computing  environment  used  to  investigate,  demonstrate  and  test 
the  concepts  of  information  management  and  information 
integration  in  the  context  of  Aerospace  Manufacturing.  The  IISS 
addresses  the  problems  of  integration  of  data  resident  on 
heterogeneous  databases  supported  by  heterogeneous  computers 
interconnected  via  a  local  Area  Network. 

Mapping:  The  correspondence  of  independent  objects  in  two 
schemas:  ES  to  CS  or  CS  to  IS. 

Network  Transaction  Manager:  (NTM)  Performs  the 
coordination,  communication  and  housekeeping  functions  required 
to  integrate  the  application  processes  and  system  services 
resident  on  the  various  hosts  into  a  cohesive  system. 

Neutral  Data  Manipulation  Language:  (NDML)  A  language 
developed  by  the  IISS  project  to  provide  uniform  access  to 
common  data,  regardless  of  database  manager  or  distribution 
criteria.  It  provides  distributed  retrieved  and  single  node 
updates . 


2-2 
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ORACLE :  Relational  DBMS  based  on  the  SQL  (Structured  Query 

Language,  a  product  of  ORACLE  Corp,  Menlo  Park,  CA).  The  CDM  is 
an  ORACLE  database . 

Parcel :  A  sequential  file  containing  sections  source  code 

of  the  input  application  program. 

Request  Processor:  (RP)  A  COBOL  program  that  will  satisfy 
a  retrieval  or  update  NDML  subtransaction  against  a  particular 
Database  Management  System. 

User  Interface:  (UI)  Controls  the  user's  terminal  and 
interfaces  with  the  rest  of  the  system. 

Virtual  Terminal  Interface:  (VTI)  Performs  the  interfacing 
between  different  terminals  and  the  UI .  This  is  done  by 
defining  a  specific  set  of  terminal  features  and  protocols  which 
must  be  supported  by  UI  software  which  constitutes  the  Virtual 
Terminal  definition.  Specific  terminals  are  then  mapped  against 
the  Virtual  Terminal  software  by  specific  software  modules 
written  for  each  type  of  terminal  supported. 
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SECTION  3 
REQUIREMENTS 


3. 1  Structural  Description 

The  graphic  portrayal  of  this  CPCI  is  included  in  Section 
3.10.  This  chart  shows  the  hierarchical  relationship  of  each 
module  making  up  this  CPCI. 

The  Union  Aggregator  uses  the  lower  level  module  to  handle 
specific  operations.  An  example  of  this  type  of  operation  is 
the  VAX-11  sort/merge  utility  to  combine  to  two  input  files. 

The  Not  in  Set  Aggregator  uses  the  following  lower  level 
modules  to  handle  specific  operations  such  as: 

1.  NOT  IN  SET  sort  routine  (NISSORT) 

2.  Opens  the  input  and  output  NIS  files  (NISOPEN) 

3.  Control  the  comparison  of  the  NIS  fields  (NISCMD) 

4.  Reads  the  NIS  file  and  create  character  buffer 
(NISREAD) 

5.  Write  the  NIS  buffer  to  results  file  (NISWRIT) 

6.  Close,  the  NIS  files  (NISCLOS) 

The  Join  Aggregator  uses  the  following  lower  level  modules 
to  handle  specific  operations  such  as: 

1.  Create  a  relative  address  file  (CDF).  (CRTHDR) . 

2.  Create  the  relative  access  file  for  rel .  (CRTCDR). 

3.  Determine  in  words  size  of  the  record  (CALCRL) . 

4.  Populate  attribute  data  item  (CRTATR). 

5.  Sorting  a  file  (SORT). 

6.  Store  the  sorting  criteria  for  a  single  attribute 
(SRTATT). 
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7.  Retrieve  the  next  record  from  the  CDF  file  (GETREL). 

8.  Retrieve  contents  of  entity  class  (GET). 

9.  Retrieve  an  attribute  from  a  record  (GETFLD) . 

10.  DB  AP  used  to  init/change  an  att  value  (PUTATT). 

11.  Write  current  record  (WRTCDR) . 

12.  Update  header  record  (UPDHDR) . 

13.  Write  the  relative  file  to  join  result  file  (RDRSFL) . 

14.  Close  all  files  used  by  the  aggregators  (RDRCLS). 

3 . 2  Functional  Flow 

This  CPC I  implemented  the  logic  defined  in  the  Development 
Specification  for  this  CPCI .  Details  of  inputs/outputs  and 
relationships  between  modules  are  found  in  Section  3.10. 

This  CPCI  has  been  designated  to  operate  in  a  batch  or 
interactive  mode.  It  must  operate  in  the  system  environment 
established  for  IISS;  that  is,  the  Network  Transaction  Manager . 
It  currently  can  only  be  executed  on  the  DEC  VAX  due  to  the 
dependence  on  the  VAX  sort  although  this  has  been  identified  for 
change  for  execution  on  the  IBM. 

3 . 3  Interfaces 

The  following  diagram  depicts  the  interface  of  the 
Aggregator  and  the  other  CPCI ' s . 
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I 

!  3.3.1  Inputs /Outputs 

i 

The  following  table  shows  the  inputs  and  outputs  of  this 
CPCI .  A  detailed  description  for  each  item  can  be  found  in  the 
DS  for  this  CPCI. 


INPUT  _ _ OUTPUT 


UNION:  Input  File  Names 

Results  File  Name 
Attribute  Pair  List  (Keys) 

Results  Field  Table  (Key  Des 

NOT  IN  SET:  Input  File  Names 
Results  File  Name 
Attribute  Pair  List 

Results  Field  Table  for 
Each  Input  File 
Results  Field  Table  for 
Results  File 

3.4  Program  Interrupts 
Not  applicable  to  this  CPCI. 

3.5  Timing  and  Sequencing  Descript i 

This  CPCI  is  activated  for  each  aggregation  called  for  by 
the  distributed  request  supevisor  (DRS). 

3.6  Special  Control  Features 
Not  applicable  to  this  CPCI. 

> 

[  3.7  Storage  Allocation 

i 

!  3.7.1  Database  Definition 


Result  File  Name 
Status 

) 

Results  File  Name 
Status 

Number  of  Records 
in  Result  File 


on 


The  database  used  by  this  CPCI  is  the  Common  Data  Model 
(CDM)  database.  The  model  is  defined  by  the  CDM1 ,  the  IDEF1 
model  of  the  CDM,  Reference  Document  Number  3. 


3. 7. 1.1  File  Description 

No  permanent  files  have  been  defined  for  this  CPCI.  It  may 
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use  temporary  scratch  files  for  input  and  output  results. 

3. 7. 1.2  Table  Description 

All  tables  used  by  this  CPCI  have  been  defined  by  the 
Development  Specification  for  this  CPCI. 

3. 7. 1.3  Item  Description 

Not  applicable  to  this  CPCI. 


3 . 8  Object  Code  Creation 

The  object  code  for  this  CPCI  will  be  created  by  the  system 
integration  team  using  defined  IISS  Software  Configuration 
Management  procedures.  This  CPCI  will  use  the  COBOL  and  FORTRAN 
language  compilers . 

3.9  Adaptation  Data 

This  CPCI  has  been  using  ANSI  COBOL  and  FORTRAN  languages. 
The  intent  was  to  provide  a  transportable  system.  Any  system 
environment  supporting  these  languages,  a  virtual  memory 
management  schema,  the  COMM  and  NTM  subsystems  of  IISS  and  the 
ORACLE  Database  Management  System  should  be  able  to  localize  and 
identify  any  machine  or  environment  dependent  modules  through 
the  original  design  of  the  IISS  and  application  of  Configuration 
Management  Procedures . 

3. 10  Detail  Design  Description 

The  following  sections  have  been  computer  generated  for 
this  CPCI. 

3.10.1  Main  Program  List 

The  following  is  a  list  of  all  "Main  Programs”  which 
are  modules  that  are  not  called  by  any  other  module  being 
documented  here.  These  modules  are  either  program  entry  points 
or,  if  they  are  hooked  into  another  set  of  programs  via 
subroutine  calls,  they  are  the  points  the  external  programs  can 
call  and  therefore  enter  through.  To  differentiate  between  the 
two  types  of  entry  points,  look  at  the  individual  Module 
Documentation  (section  3.10.8)  and  look  at  Module  Type  for  each 
of  the  Main  Program  modules  listed.  Note  whether  the  routine 
is  a  Program,  Subroutine,  or  Function.  If  it  is  a  Program,  it 
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is  truly  a  main  program  entry  point.  If  not,  then  it  is  merely 
called  by  other  programs  not  being  documented  here. 
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Module 

ANAATT 

ANABOO 

ANAREL 

ANAVAL 

CDJ01 

CDN01 

CD001 

CONCAT 

HOLCHR 

RDCDFR 

RELFTN 


DATA  AGGREGATORS  Main  Program  List 
Name  Purpose 

DETERMINE  LEGALITY  OF  ATTRIBUTE  NAME 
VERIFY  A  BOOLEAN  CONDITION 
DETERMINE  VALIDTY  OF  RELATIONAL  OPERATOR 
CONVERT  VALUE  OF  ATTRIBUTE  TYPE 
AGGREGATOR  JOIN  FUNCTION 
AGGREGATOR  NOT  IN  SET  FUNCTION 
AGGREGATOR  UNION  FUNCTION 
CONCATENATE  TVO  STRINGS 
CONVERT  DATA  FROM  HOLLERITH  TO  CHARACTER 
»***  PURPOSE  NOT  FOUND  BY  STRIPPER  •*** 
CONVERT  REAL  NUMBER  TO  CHARACTER  STRING 


3-7 


V  * 
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3.10.2  Module  List 

The  following  is  a  list  of  all  the  modules  being 
documented  here  along  with  their  purpose.  Each  module  has  a 
unique  name,  no  matter  what  language  it  was  written  in. 


3-8 
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Module 

ACTLEN 

ADDCHN 

ANAATT 

ANABOO 

ANAREL 

ANAVAL 

CALCRL 

CDJ01 

CDN01 

CDU01 

CHGPTR 

CHKRNG 

CHREAL 

CHRHOL 


DATA  AGGREGATORS  Module  List 
Name  Purpose 

DETERMINE  LENGTH  OF  CHARACTER  STRING 
ADD  ATTRIBUTE  TO  LINKED  LIST 
DETERMINE  LEGALITY  OF  ATTRIBUTE  NAME 
VERIFY  A  BOOLEAN  CONDITION 
DETERMINE  VALIDTY  OF  RELATIONAL  OPERATOR 
CONVERT  VALUE  OF  ATTRIBUTE  TYPE 
DETERMINE  IN  WORDS  .SIZE  OF  THE  RECORD 
AGGREGATOR  JOIN  FUNCTION 
AGGREGATOR  NOT  IN  SET  FUNCTION 
AGGREGATOR  UNION  FUNCTION 
ADJUST  COMMON  DATA  RECORD  POINTER 
PERFORM  ATTRIBUTE  VALUE  RANGE  CHECKS 
CHARACTER  TO  REAL  CONVERSIONS 
CONVERT  CHAR  STRING  TO  INTEGER  ARRAY 


CHRINT 


CHARACTER  TO  INTEGER  CONVERSION 
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Module 

CONCAT 

CONDI G 

CRTATR 

CRTBOF 

CRTCDR 

CRTHDR 

FORCLS 

GACHK 

GAINFO 

GET 

GETATT 

GETCHK 

GETFLD 


DATA  AGGREGATORS  Module  List 
Name  Purpose 

CONCATENATE  TWO  STRINGS 

CONVERTS  SIGN  OF  SIGNED  VALUE  TO  DIGIT  VAL 

POPULATE  ATTRIBUTE  DATA  ITEMS 

CREATE  CHAR.  STRING  FOR  FIELD  COMPARISON 

CREATE  THE  RELATIVE  ACCESS  FILE  FOR  REL. 

CREATE  A  RELATIVE  ADDRESS  FILE  (CDF) 

CLOSE  ALL  FILES  USED  BY  THE  AGGREGATORS 

CHECK  INPUT  PARAMETERS  OF  'GETATT'  CALL 

STORE  ATTRIBUTE  INFORMATION  IN  COMMON 
BLOCK** 

RETRIEVE  CONTENTS  OF  ENTITY  CLASS 
RETRIEVE  ATTRIBUTE  INFORMATION 
CHECK  INPUT  PARAMETERS  OF  'GET'  FOR  ERRORS 
RETRIEVE  AN  ATTRIBUTE  FROM  A  RECORD 


GETITM 


EXTRACT  ATTRIBUTE  VALUE  FROM  USER'S  BUFFER 
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Module  Name 

GETPTR 

GETREL 

HOLCHR 

INTCHR 

INTSRT 

NISCLOS 

NISCMD 

NISINT 

NISOPEN 

NISREAD 

NISREL 

NISSORT 

NISWRIT 


DATA  AGGREGATORS  Module  List 
Purpose 

DETERMINE  NEXT  CURRENT  RECORD  POINTER 

RETRIEVE  THE  NEXT  RECORD  FROM  THE  CDF  FILE 

CONVERT  DATA  FROM  HOLLERITH  TO  CHARACTER 

CONVERT  INTEGER  VALUE  TO  CHARACTER  STRING 

FILL  KEY  ARRAY  USED  BY  THE  VAX  SORT 
ROUTINE** 

THIS  PROCESS  CLOSES  THE  NIS  FILES 

CONTROL  THE  COMPARISON  OF  THE  NIS  FIELDS 

CONVERTS  A  STRING  NUMBER  TO  AN  INTERGER 

OPENS  THE  INPUT  AND  OUTPUT  NIS  FILES 

READS  THE  NIS  FILE  AND  CREATE  CHAR  BUFFER 

CONVERTS  CHAR  STRING  TO  REAL  VAL  W/NO 
DIGIT** 

NOT- IN -SET  SORT  ROUTINE 

TO  WRITE  THE  NIS  BUFFER  TO  RESULTS  FILE 


PACHK 


CHECK  THE  PARAMETERS  OF  THE  PUTATT  CALL 
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Modu 1 e 

PUTATT 

PUTITM 

RDCDFR 

RDCDR 

RDHDR 

RDRSFL 

REALCH 

RELFTN 

RETCDR 

SACHK 

SORT 

SRTATT 

SRTCDR 


DATA  AGGREGATORS  Module  List 
Name  Purpose 

DB  AP  USED  TO  IN IT/ CHANGE  AN  ATT  VALUE 

CONVERTS  VAL  SUPPLIED  AND  STORES  IN  BUFFER 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

RETURN  THE  CONTENTS  OF  A  COMMON  DATA 
RECORD*  * 

READ  HEADER  RECORD  TO  DETERMINE  PROCESSING 

WRITE  THE  RELATIVE  FILE  TO  JOIN  RESULT 
FILE*  * 

CONVERT  REAL  NUMBER  TO  CHARACTER  STRING 
CONVERT  REAL  NUMBER  TO  CHARACTER  STRING 
SORTING  AND  WRITE  RECORD 
SORTING  THE  ATTRIBUTE  RECORDS 
SORTING  A  FILE 

STORE  THE  SORTING  CRITERIA  FOR  A  SINGLE 
ATTRIBUTE  ** 

SORTING  THE  COMMON  DATA  RECORD 


TRMSRT 


TERMINATE  THE  SORTING 
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Module 

UPDHDR 

WRTATT 

WRTCDR 

WRTHDR 


DATA  AGGREGATORS  Module  List 
Name  Purpose 

UPDATE  HEADER  RECORD 
WRITE  ATTRIBUTE  RECORD 
WRITE  CURRENT  RECORD 
WRITE  RECORD  HEADER 


WRTREL 


WRITE  A  RECORD  TO  THE  RESULT  FILE 
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3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  module  is  documented  may 
be  found  in  the  Module  Documentation  Index  (Document  Number 
CM  620100001).  See  section  3.10.6  for  a  list  of  the  modules 
that  call  each  of  these  external  routines. 
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DATA  AGGREGATORS  External 
Module  Name 


BLANKH 

DELFIL 

ERR PRO 

F0R$CL0SE 

FOR$ INQUIRE 

FORSOPEN 

GENFIL 

INITAL 

LIBS INDEX 

NSEND 

RCV 

RMATR 

SIGERR 

SORS  END_SORT 

SORS INIT_SORT 

SOR  S  PASS_F I LES 

SORS  RELEASEREC 

SORSRETURNREC 

SORSSORTMERGE 

STRMOV 

TOKEN 

TRMNAT 

WHTHST 


Routines  List 
First  User 


ANAVAL 

CDJ01 

CDU01 

RDRSFL 

SORT 

N ISOPEN 

CDN01 

CDU01 

GETPTR 

CDN01 

CDJ01 

ANAVAL 

CDU01 

CDU01 

CDU01 

CDU01 

SRTCDR 

RETCDR 

NISSORT 

CDJ01 

ANAREL 

CDJ01 

CDU01 
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3.10.4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in 
by  modules  being  documented  here.  Each  include  file  has  a 
unique  name  regardless  of  the  language  being  used.  The  purpose 
of  each  include  file  is  listed  as  well.  A  more  complete 
description  of  each  include  file  is  given  in  section  3.10.9. 

The  purpose  listed  is  the  one  that  is  in  the  source  code  of  the 
include  file. 

A  purpose  of  "**•*  PURPOSE  NOT  FOUND  BY  STRIPPER  ***** 
indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself.  The  most  common  reason  for  this  is  that 
the  include  file  comes  from  system  libraries  that  were  not 
developed  by  the  project,  such  as  'C'  libraries  that  are 
provided  with  the  'C'  compiler. 

See  section  3.10.6  for  a  set  of  lists  which  show  all 
the  modules  which  call  in  each  of  these  include  files. 
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DATA  AGGREGATORS  Include  File  List 
File  Name  Purpose 


AGGMSG  AGGREGATOR  INPUT  MESSAGE 

APL  JOIN  QUERY  ATTRIBUTE  PAIR  LIST 

ATTRINF . INF*  *  *  *  PURPOSE  NOT  FOUND  BY  STRIPPER  **•* 
CHKCDM  IISS  CDMP  CHECK  STATUS  CODES 

ERRCDM  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

ERRPRO  PROCESS  ERROR  INCLUDE  FILE 

HDRINFO. INF*  *  *  *  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
JQGTBL  JOIN  QUERY  GRAPH  TELLS  HOW  TO  CONNECT 
SUBTRANSACTIONS 

MACHDEP . INF*  *  *  *  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
RFTAB2  THE  RESULT  FIELD  TABLE 

RFTABLE  THE  RESULT  FIELD  TABLE 

SRVRET  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

STDRESP  WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 


3-17 
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3.10.5  Where  Include  File  Used  List 

The  following  lists  each  include  file  from  3.10.4  and 
all  the  modules  documented  in  this  specification  which  include 
them.  The  purpose  of  each  module  is  listed  as  well. 


3-18 
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DATA  AGGREGATORS  Where-include-f i le-used  List 


Include  Module  Module 

File  Name  Purpose 


AGGMSG 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 

CDU01  AGGREGATOR  UNION  FUNCTION 


APL 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 


ATTRINF . INF 

ADDCHN  ADD  ATTRIBUTE  TO  LINKED  LIST 
ANAATT  DETERMINE  LEGALITY  OF  ATTRIBUTE  NAME 

CRTATR  POPULATE  ATTRIBUTE  DATA  ITEMS 

GACHK  CHECK  INPUT  PARAMETERS  OF  'GETATT'  CALL 
GAINFO  STORE  ATTRIBUTE  INFORMATION  IN  COMMON 

BLOCK** 

GETATT  RETRIEVE  ATTRIBUTE  INFORMATION 

INTSRT  FILL  KEY  ARRAY  USED  BY  THE  VAX  SORT 
ROUTINE* • 

PACHK  CHECK  THE  PARAMETERS  OF  THE  PUTATT  CALL 

PUTATT  DB  AP  USED  TO  INIT/CHANGE  AN  ATT  VALUE 
SACHK  SORTING  THE  ATTRIBUTE  RECORDS 

WRTATT  WRITE  ATTRIBUTE  RECORD 
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DATA  AGGREGATORS  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


CHKCDM 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 

CDU01  AGGREGATOR  UNION  FUNCTION 


ERRCDM 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 

CDU01  AGGREGATOR  UNION  FUNCTION 

NISSORT  NOT-IN-SET  SORT  ROUTINE 


ERRPRO 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 

CDU01  AGGREGATOR  UNION  FUNCTION 

NISSORT  NOT-IN-SET  SORT  ROUTINE 


HDRINFO . INF 

ADDCHN  ADD  ATTRIBUTE  TO  LINKED  LIST 
ANAATT  DETERMINE  LEGALITY  OF  ATTRIBUTE  NAME 
CHGPTR  ADJUST  COMMON  DATA  RECORD  POINTER 
CRTCDR  CREATE  THE  RELATIVE  ACCESS  FILE  FOR  REL. 
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DATA  AGGREGATORS  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


CRTHDR  CREATE  A  RELATIVE  ADDRESS  FILE  (CDF) 

GET  RETRIEVE  CONTENTS  OF  ENTITY  CLASS 

GETATT  RETRIEVE  ATTRIBUTE  INFORMATION 

GETCHK  CHECK  INPUT  PARAMETERS  OF  GET'  FOR  ERRORS 
INTSRT  FILL  KEY  ARRAY  USED  BY  THE  VAX  SORT 
ROUTINE** 

PUTATT  DB  AP  USED  TO  INIT/CHANGE  AN  ATT  VALUE 
RDCDFR  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **•• 
RDHDR  READ  HEADER  RECORD  TO  DETERMINE  PROCESSING 

RDRSFL  WRITE  THE  RELATIVE  FILE  TO  JOIN  RESULT 

FILE** 

RETCDR  SORTING  AND  WRITE  RECORD 

SACHK  SORTING  THE  ATTRIBUTE  RECORDS 

SORT  SORTING  A  FILE 

SRTATT  STORE  THE  SORTING  CRITERIA  FOR  A  SINGLE 
ATTRIBUTE  ** 

TRMSRT  TERMINATE  THE  SORTING 

UPDHDR  UPDATE  HEADER  RECORD 

WRTHDR  WRITE  RECORD  HEADER 


JQGTBL 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDNOl  AGGREGATOR  NOT  IN  SET  FUNCTION 
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DATA  AGGREGATORS  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


MACHDEP. INF 

CALCRL  DETERMINE  IN  WORDS  .SIZE  OF  THE  RECORD 
CHRHOL  CONVERT  CHAR  STRING  TO  INTEGER  ARRAY 

HOLCHR  CONVERT  DATA  FROM  HOLLERITH  TO  CHARACTER 


RFTAB2 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 


RFTABLE 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 

CDU01  AGGREGATOR  UNION  FUNCTION 


SRVRET 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 

CDU01  AGGREGATOR  UNION  FUNCTION 


STDRESP 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 
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DATA  AGGREGATORS  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 

CD001  AGGREGATOR  UNION  FUNCTION 
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3.10.6  Where  External  Routine  Used  List 

The  following  lists  each  external  function  or  routine 
listed  in  3.10.3  and  all  the  documented  modules  which  call  it. 
The  purpose  of  each  module  is  listed  as  well. 
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DATA  AGGREGATORS  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


BLANKH 

ANAVAL  CONVERT  VALUE  OF  ATTRIBUTE  TYPE 


DELFIL 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 


ERRPRO 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDNOl  AGGREGATOR  NOT  IN  SET  FUNCTION 

CDU01  AGGREGATOR  UNION  FUNCTION 

NISSORT  NOT-IN-SET  SORT  ROUTINE 


FORSCLOSE 

CRTCDR  CREATE  THE  RELATIVE  ACCESS  FILE  FOR  REL. 
FORCLS  CLOSE  ALL  FILES  USED  BY  THE  AGGREGATORS 
NISCLOS  THIS  PROCESS  CLOSES  THE  NIS  FILES 
RDCDFR  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  •*** 
RDRSFL  WRITE  THE  RELATIVE  FILE  TO  JOIN  RESULT 
FILE** 


FOR* INQUIRE 

GET  RETRIEVE  CONTENTS  OF  ENTITY  CLASS 

GETATT  RETRIEVE  ATTRIBUTE  INFORMATION 

PUTATT  DB  AP  USED  TO  INIT/CHANGE  AN  ATT  VALUE 
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DATA  AGGREGATORS  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


SORT  SORTING  A  FILE 

SRTATT  STORE  THE  SORTING  CRITERIA  FOR  A  SINGLE 
ATTRIBUTE  ** 


FORSOPEN 

CRTCDR  CREATE  THE  RELATIVE  ACCESS  FILE  FOR  REL . 
CRTHDR  CREATE  A  RELATIVE  ADDRESS  FILE  (CDF) 

N ISOPEN  OPENS  THE  INPUT  AND  OUTPUT  NIS  FILES 

RDCDFR  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
RDRSFL  WRITE  THE  RELATIVE  FILE  TO  JOIN  RESULT 
FILE** 


GENFIL 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 

CDU01  AGGREGATOR  UNION  FUNCTION 


INITAL 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 

CDU01  AGGREGATOR  UNION  FUNCTION 


LIBS  INDEX 

ANABOO  VERIFY  A  BOOLEAN  CONDITION 

<*NAREL  DETERMINE  VALIDTY  OF  RELATIONAL  OPERATOR 
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DATA  AGGREGATORS  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


ANAVAL  CONVERT  VALUE  OF  ATTRIBUTE  TYPE 
CHGPTR  ADJUST  COMMON  DATA  RECORD  POINTER 
CHKRNG  PERFORM  ATTRIBUTE  VALUE  RANGE  CHECKS 
CHREAL  CHARACTER  TO  REAL  CONVERSIONS 

GETCHK  CHECK  INPUT  PARAMETERS  OF  'GET'  FOR  ERRORS 
GETPTR  DETERMINE  NEXT  CURRENT  RECORD  POINTER 


NSEND 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 

CDU01  AGGREGATOR  UNION  FUNCTION 


RCV 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 

CDU01  AGGREGATOR  UNION  FUNCTION 


RMATR 

ANAVAL  CONVERT  VALUE  OF  ATTRIBUTE  TYPE 


SIGERR 

CDJ01  AGGREGATOR  JOIN  FUNCTION 

CDN01  AGGREGATOR  NOT  IN  SET  FUNCTION 

CDU01  AGGREGATOR  UNION  FUNCTION 
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DATA  AGGREGATORS  Where-external-rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


SORSENDSORT 

CDUOl  AGGREGATOR  UNION  FUNCTION 

NISSORT  NOT- IN-SET  SORT  ROUTINE 

TRMSRT  TERMINATE  THE  SORTING 


SORSINITSORT 

CDUOl  AGGREGATOR  UNION  FUNCTION 

INTSRT  FILL  KEY  ARRAY  USED  BY  THE  VAX  SORT 
ROUTINE** 

NISSORT  NOT- IN-SET  SORT  ROUTINE 


SOR$PASS_FILES 

CDUOl  AGGREGATOR  UNION  FUNCTION 

NISSORT  NOT-IN-SET  SORT  ROUTINE 


SORSRELEASEREC 

SRTCDR  SORTING  THE  COMMON  DATA  RECORD 


SOR  $  RETURNREC 

RETCDR  SORTING  AND  WRITE  RECORD 


SORS  SORT_MERGE 

CDUOl  AGGREGATOR  UNION  FUNCTION 

NISSORT  NOT-IN-SET  SORT  ROUTINE 
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DATA  AGGREGATORS  Where-external -routine-used  List 


System 

Module 

Module 

Name 

Module 

Purpose 

SRTCDR 

SORTING  THE  COMMON  DATA  RECORD 

STRMOV 

CDJ01 

AGGREGATOR  JOIN  FUNCTION 

TOKEN 

ANAATT 

ANABOO 

ANAREL 

ANAVAL 

DETERMINE  LEGALITY  OF  ATTRIBUTE 
VERIFY  A  BOOLEAN  CONDITION 
DETERMINE  VALIDTY  OF  RELATIONAL 
CONVERT  VALUE  OF  ATTRIBUTE  TYPE 

NAME 

OPERATOR 

TRMNAT 

CDJ01 

CDN01 

CDU01 

AGGREGATOR  JOIN  FUNCTION 
AGGREGATOR  NOT  IN  SET  FUNCTION 
AGGREGATOR  UNION  FUNCTION 

WHTHST 

CDN01 

CDU01 

AGGREGATOR  NOT  IN  SET  FUNCTION 
AGGREGATOR  UNION  FUNCTION 
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3.10.7  Main  Program  Parts  List 

The  following  lists  each  Main  Program  listed  in  3.10.1 
and  all  the  modules  which  are  called  either  by  that  module 
itself  or  by  any  of  the  documented  modules  which  it  calls.  It 
is  possible  for  a  non-main  module  to  be  listed  more  that  once 
if  it  is  called  by  multiple  modules.  The  called  modules,  in 
this  case  known  as  program  parts,  are  marked  as  to  whether 
they  are  documented  here.  If  so,  the  phrase  “wel 1 -defined 
module"  appears  by  the  module  name,  if  not  it  is  an  "external 
"routine".  The  Purpose  of  the  Main  Program  module  is  listed 
as  well. 
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DATA  AGGREGATORS  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

ANAATT 

GAINFO 

TOKEN 

Purpose—  > DETERMINE  LEGALITY  OF  ATTRIBUTE 
NAME  *» 

Well-defined  module 

External  routine 
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DATA  AGGREGATORS  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


ANABOO  Purpose— > VERIFY  A  BOOLEAN  CONDITION 

LIBS INDEX  External  routine 

TOKEN  External  routine 
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DATA  AGGREGATORS  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


ANAREL  Purpose— > DETERMINE  VALIDTY  OF  RELATIONAL 

OPERATOR  * • 

LIBJINDEX  External  routine 

TOKEN  External  routine 
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DATA  AGGREGATORS  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


ANAVAL 


Purpose — 

BLANKH 

CHREAL 

CKRHOL 

CHR1NT 

GAINFO 

LIBS INDEX 

RMATR 

TOKEN 


.CONVERT  VALUE  OF  ATTRIBUTE  TYPE 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
External  routine 
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DATA  AGGREGATORS  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


CDJ01 

ACTLEN 
ADDCHN 
CALCRL 
CHGPTR 
CHKRNG 
CHREAL 
CHRINT 
CRTATR 
CRTCDR 
CRTHDR 
DELFIL 
ERR PRO 
FORSCLOSE 
FOR$ INQUIRE 
FORSOPEN 
FORCLS 
GACHK 
GAINFO 
GENFIL 
GET 

GETATT 

GETCHK 

GETFLD 

GETITM 

GETPTR 

GETREL 

INITAL 

INTCHR 

INTSRT 

LIBS INDEX 

NSEND 

PACHK 

PUTATT 

PUTITM 

RCV 

RDCDR 

RDHDR 

RDRSFL 

REALCH 


Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
Well-defined  module 
Well -def i ned  modu 1 e 
Well-defined  module 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 


Purpose-- > AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


RETCDR 

SACHK 

SIGERR 

SORS END  SORT 

SORSINIT  SORT 

SORSRELEASEREC 

SORSRETURNREC 

SORSSORTMERGE 

SORT 

SRTATT 

SRTCDR 

STRMOV 

TRMNAT 

TRMSRT 

UPDHDR 

WRTATT 

WRTCDR 

WRTHDR 

WRTREL 


i 


j 


3-36 


Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
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DATA  AGGREGATORS  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


CDN01  Purpose-- > AGGREGATOR  NOT  IN  SET  FUNCTION 


CONDIG 

Well-defined  module 

CRTBUF 

Well-defined  module 

DELFIL 

External 

routine 

ERRPRO 

External 

routine 

FORECLOSE 

External 

routine 

FORSOPEN 

External 

routine 

GENFIL 

External 

routine 

INITAL 

External 

routine 

NISCLOS 

Well-defined  module 

NISCMD 

Well-defined  module 

NISINT 

Well-defined  module 

N ISOPEN 

Well-defined  module 

NISREAD 

Well-defined  module 

NISREL 

Well-defined  module 

NISSORT 

Well-defined  module 

NISWRIT 

Well-defined  module 

NSEND 

External 

routine 

RCV 

External 

routine 

SIGERR 

External 

routine 

SORSEND  SORT 

External 

routine 

SORSINIT  SORT 

External 

routine 

SOR$PASS  FILES 

External 

routine 

SORSSORT  MERGE 

External 

routine 

TRMNAT 

External 

routine 

WHTHST 

External 

routine 

3-37 


PS  620141320 
1  November  1985 


DATA  AGGREGATORS  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CDU01 

Purpose-- 

.AGGREGATOR  UNION  FUNCTION 

ERRPRO 

External 

routine 

GENFIL 

External 

routine 

INITAL 

External 

routine 

NSEND 

External 

routine 

RCV 

External 

routine 

S1GERR 

External 

routine 

SORSEND  SORT 

External 

routine 

SORSINIT  SORT 

External 

routine 

SORSPASS  FILES 

External 

routine 

SORJSORT  MERGE 

External 

routine 

TRMNAT 

External 

routine 

WHTHST 

External 

routine 
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DATA  AGGREGATORS  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CONCAT 

Purpose-- >  CONCATENATE  TWO  STRINGS 

ACTLEN 

Well-defined  module 
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DATA  AGGREGATORS  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


RDCDFR 


Purpose —  >  *  *  *  *  PURPOSE  NOT  FOUND  BY 
STRIPPER  ***» 

FORSCLOSE  External  routine 

FORSOPEN  External  routine 

RDCDR  Well-defined  module 

RDHDR  Well-defined  module 

WRTREL  Well-defined  module 
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3.10.8  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  being  documented 
in  this  specification  as  listed  in  section  3.10.2.  It 
provides  a  compact  way  of  getting  information  that  would  be 
otherwise  buried  within  each  module's  source  code. 


The  specific  items  in  this  module  documentation  have  the 
following  meanings: 

NAME:  Name  of  program  Module. 


PURPOSE : 


Purpose  of  Module  as  detailed  in  the 
source  code. 


LANGUAGE:  Programming  language  source  code  is 

written  in. 

The  choices  are: 

VAX- 11  FORTRAN 

C  (I/S-l  Workbench  C) 

VAX- 11  COBOL 

MODULE  TYPE:  Whether  a  Program,  Subroutine,  or 

Function . 


SOURCE  FILE: 

SOURCE  FILE  TYPE: 


HOST: 


SUBSYSTEM : 


Name  of  Source  File  from  file 
specification. 

Source  File  Extension  from  file 
specification . 

Whether  this  is  a  host -dependent 
routine  (VAX  or  IBM)  or  blank  if 
host- independent . 

IISS  sub-system  this  file  resides  in. 


SUBDIRECTORY: 


Sub-directory  of  that  subsystem  in 
which  this  file  resides. 


DOCUMENTATION  GROUP:  Name  of  documentation  group  of  which 

this  source  file  is  a  member. 


DESCRIPTION: 


A  description  of  the  module  as  otained 
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from  the  source  code. 

ARGUMENTS:  The  arguments  with  which  this  routine 

is  called  if  it  is  a  Subroutine  or  a 
Function. 

INCLUDE  FILES:  A  list  of  all  the  files  that  are 

included  into  this  module  as  well  as 
their  purposes. 

ROUTINES  CALLED:  Subroutines  or  Functions,  either 

documented  or  external,  called  by 
this  module,  if  any. 

CALLED  DIRECTLY  BY:  The  documented  routines  which  call 

this  module,  if  any. 

USED  IN  MAIN  PROGRAM ( S ) :  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10.7. 


The  Module  Documentation  is  arranged  alphabetically  according 
to  Module  Name. 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


ACTLEN 

DETERMINE  LENGTH  OF  CHARACTER  STRING 
VAX- 11  FORTRAN 
SUBROUTINE 
ACTLEN 
.FOR 

CDM 

PS41320 


DESCRIPTION: 


THIS  PRIMITIVE  WILL  BE 
USED  TO  DETERMINE  THE 
LENGTH  OF  THE  CHARACTER 
STRING  PASSED  TO  IT 

ARGUMENTS : 


STRING  *  CHAR 
LENGTH  -  1*4 


CALLED  DIRECTLY  BY: 


CHKRNG  -  PERFORM  ATTRIBUTE  VALUE  RANGE  CHECKS 

CONCAT  -  CONCATENATE  TWO  STRINGS 


USED  IN  MAIN  PROGRAM(S) : 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 

CONCAT  -  CONCATENATE  TWO  STRINGS 
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DATA  AGGREGATORS  hc-dule  Documentation 


NAME :  ADDCHN 

PURPOSE:  ADD  ATTRIBUTE  TO  LINKED  LIST 

LANGUAGE:  VAX- 11  FORTRAN 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE:  ADDCHN 

SOURCE  FILE  TYPE:  .FOR 

HOST: 

SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 
DESCRIPTION: 


ARGUMENTS : 


ATRADR  -  1*4 

CDFLU  -  1*4 


INCLUDE  FILES: 


ATTRINF . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
HDRINFO . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  ATT 
CATT 
I  HD 
CHD 


ROUTINES  CALLED: 


WRTATT  -  WRITE  ATTRIBUTE  RECORD 

WRTHDR  -  WRITE  RECORD  HEADER 


CALLED  DIRECTLY  BY: 


3-44 


PS  620141320 
1  November  1985 


SRTATT  -  STORE  THE  SORTING  CRITERIA  FOR  A  SINGLE 

ATTRIBUTE 

USED  IN  MAIN  PROGRAM(S) : 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


ANAATT 

DETERMINE  LEGALITY  OF  ATTRIBUTE  NAME 

VAX- 11  FORTRAN 

SUBROUTINE 

ANAATT 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


SC  -  1*4 

START  -  1*4 

CDFLU  -  1*4 

RC  *  1*4 


INCLUDE  FILES: 


ATTRINF . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
HDRINFO. IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  ATT 
CATT 
I  HD 
CHD 


ROUTINES  CALLED: 


GAINFO  -  STORE  ATTRIBUTE  INFORMATION  IN  COMMON  BLOCK** 

TOKEN 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


ANABOO 

VERIFY  A  BOOLEAN  CONDITION 

VAX- 11  FORTRAN 

SUBROUTINE 

ANABOO 

.FOR 

CDM 

PS41320 


DESCRIPTION: 


ARGUMENTS : 


SC  -  CHAR 
START  -  1*4 

END  -  L*4 

BOOL  -  CHAR 
RC  -  1*4 


ROUTINES  CALLED: 


LIBS INDEX 
TOKEN 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


ANAREL 

DETERMINE  VALIDTY  OF 

VAX- 11  FORTRAN 

SUBROUTINE 

ANAREL 

.FOR 

CDM 

PS41320 


RELATIONAL  OPERATOR 


ARGUMENTS : 


SC  -  CHAR 
START  -  1*4 

RELOP  -  CHAR 
RC  -  1*4 


ROUTINES  CALLED: 


LIBS INDEX 
TOKEN 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


ANAVAL 

CONVERT  VALUE  OF  ATTRIBUTE  TYPE 

VAX-1 1  FORTRAN 

SUBROUTINE 

ANAVAL 

.FOR 

CDM 

PS41320 


DESCRIPTION: 


ARGUMENTS : 


SC  -  CHAR 
START  -  1*4 

VALUES  -  1*4  (1) 

REALVAL  -  R*4  (1) 

RC  -  1*4 

CDFLU  -  1*4 

ATTFLG  -  L*4 


ROUTINES  CALLED: 


BLANKH 

CHREAL 

CHRHOL 

CHRINT 

GAINFO 

LIBS INDEX 

RMATR 

TOKEN 


CHARACTER  TO  REAL  CONVERSIONS  •* 

CONVERT  CHAR  STRING  TO  INTEGER  ARRAY  »* 

CHARACTER  TO  INTEGER  CONVERSION  ** 

STORE  ATTRIBUTE  INFORMATION  IN  COMMON  BLOCK** 
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DATA  AGSGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


CALCRL 

DETERMINE  IN  WORDS 

VAX- 11  FORTRAN 

SUBROUTINE 

CALCRL 

.FOR 

CDM 


SIZE  OF  THE  RECORD 


HOST: 

SUBSYSTEM : 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


RECL  -  1*4 

RECSIZ  *  1*4 


INCLUDE  FILES: 


MACHDEP . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

BNFMDP 


CALLED  DIRECTLY  BY: 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 


USED  IN  MAIN  PROGRAM ( S ) : 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


CDJ01 

AGGREGATOR  JOIN  FUNCTION 
VAX- 11  COBOL 
PROGRAM 
CDJ01 
-COB 

CDM 

PS41320 

DESCRIPTION: 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


THE  OBJECTIVE  OF  THIS  CONFIGURATION  ITEM  IS  TO 
PERFORM  RELATION  JOINS  UPON  INTERMEDIATE  RESULTS 
OF  A  MULTI -DATABASE  TRASNSACTION .  IT,  ALONG  WITH 
THE  STAGER /SCHEDULER  Cl  AND  QUERY  PROCESSORS, 

PERFORM  THE  RUN  TIME  EVALUATION  OF  COMMANDS  PRESENTED 
TO  THEM  BY  APPLICATION  PROCESSES. 


THE  JOIN  AGGREGATOR  PERFORMS  THE  FOLLOWING: 

1.  IT  RECEIVES  AND  UNPACKS  A  MESSAGE  FROM  THE  NTH 
AND  BUILDS  APPROPRIATE  TABLES  AND  FILES  FOR  THE 
TWO  OPERAND  RELATION  AND  RESULTANT  RELATION. 

2.  IT  SORTS  THE  OPERANDS  WHICH  ARE  STORED  IN  FILES 
FOR  THE  JOIN. 

3.  IT  READS  THE  OPERAND  FILES,  PERFORMS  THE  JOIN  AND 
CREATES  THE  FILE  WHICH  WILL  CONTAIN  THE 

RESULTANT  RELATION. 

4.  IT  SENDS  A  COMPLETION  MESSAGE  TO  THE  STAGER/ 
SCHEDULER  WHICH  CONTAINS  PROGRAM  STATUS  AND 

THE  NUMBER  OF  RECORDS  IN  THE  RESULTANT  RELATION. 
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INCLUDE  FILES: 


ERRCDM 

CHKCDM 

APL 

JQGTBL 

RFTABLE 
AGGMSG 
STDRESP 
SRVRET 
ERR PRO 


IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
IISS  CDMP  CHECK  STATUS  CODES 
JOIN  QUERY  ATTRIBUTE  PAIR  LIST 
JOIN  QUERY  GRAPH  TELLS  HOW  TO  CONNECT 
SUBTRANSACTIONS 
THE  RESULT  FIELD  TABLE 
AGGREGATOR  INPUT  MESSAGE 

WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 
AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


GENFIL 

INITAL 

RCV 

SIGERR 

CRTHDR 

CRTCDR 

CALCRL 

CRTATR 

SORT 

SRTATT 

GETREL 

GET 

GETFLD 

STRMOV 

PUTATT 

WRTCDR 

UPDHDR 

RDRSFL 

FOKCLS 

NSEND 

DELFIL 

TRMNAT 

ERR PRO 


CREATE  A  RELATIVE  ADDRESS  FILE  (CDF)  ** 

CREATE  THE  RELATIVE  ACCESS  FILE  FOR  REL.  ** 
DETERMINE  IN  WORDS  .SIZE  OF  THE  RECORD  ** 

POPULATE  ATTRIBUTE  DATA  ITEMS  ** 

SORTING  A  FILE  ** 

STORE  THE  SORTING  CRITERIA  FOR  A  SINGLE 
ATTRIBUTE 

RETRIEVE  THE  NEXT  RECORD  FROM  THE  CDF  FILE  ** 
RETRIEVE  CONTENTS  OF  ENTITY  CLASS  ** 

RETRIEVE  AN  ATTRIBUTE  FROM  A  RECORD  ** 

DB  AP  USED  TO  INIT/CHANGE  AN  ATT  VALUE  ** 

WRITE  CURRENT  RECORD  ** 

UPDATE  HEADER  RECORD  ** 

WRITE  THE  RELATIVE  FILE  TO  JOIN  RESULT  FILE** 
CLOSE  ALL  FILES  USED  BY  THE  AGGREGATORS  ** 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


CDN01 

AGGREGATOR  NOT  IN  SET  FUNCTION 

VAX- 11  COBOL 

PROGRAM 

CDN01 

.COB 

CDM 

PS41320 


DESCRIPTION: 


THE  OBJECTIVE  OF  THIS  CONFIGURATION  ITEM  IS  TO 

PERFORM  RELATION  NOT  IN  SETS  UPON  INTERMEDIATE  RESULTS 

OF  A  MULTI -DATABASE  TRASNSACTION .  IT,  ALONG  WITH 

THE  DISTRIBUTED  REQUEST  SUPERVISOR  Cl  AND  REQUEST  PROCESSORS, 

PERFORM  THE  RUN  TIME  EVALUATION  OF  COMMANDS  PRESENTED 

TO  THEM  BY  APPLICATION  PROCESSES. 

IBM  NOTE 

VAX  SPECIFIC  ITEMS  WILL  BE  MARKED  WITH  AN 
IBM  COMMENT  TO  DENOTE  CHANGES  THAT  MUST  BE 
MADE  TO  HOST  THIS  MODULE  TO  THE  IBM 


THE  NOT  IN  SET  AGGREGATOR  PERFORMS  THE  FOLLOWING: 

1 .  IT  RECEIVES  AND  UNPACKS  A  MESSAGE  FROM  THE  NTM 
AND  BUILDS  APPROPRIATE  TABLES  FOR  THE 

TWO  OPERAND  RELATION  AND  RESULTANT  RELATION. 

2.  IT  PERFORMS  A  SORT/COMPARE  OPERATION  ON  THE  OPERAND 
RELATION  CREATING  THE  RESULTANT  RELATION. 

3.  IT  SENDS  A  COMPLETION  MESSAGE  TO  THE  DISTRIBUTED 
REQUEST  SUPERVISOR  WHICH  CONTAINS  PROGRAM  STATUS  AND 
THE  NUMBER  OF  RECORDS  IN  THE  RESULTANT  RELATION. 
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INCLUDE  FILES: 


RFTABLE 

RFTAB2 

APL 

JQGTBL 

AGGMSG 

STDRESP 

CHKCDM 

ERRCDM 

SRVRET 

ERRPRO 


THE  RESULT  FIELD  TABLE 
THE  RESULT  FIELD  TABLE 
JOIN  QUERY  ATTRIBUTE  PAIR  LIST 
JOIN  QUERY  GRAPH  TELLS  HOW  TO  CONNECT 
SUBTRANSACTIONS 
AGGREGATOR  INPUT  MESSAGE 

WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 
IISS  CDMP  CHECK  STATUS  CODES 
IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


INITAL 

RCV 

SIGERR 

WHTHST 

GENFIL 

NISSORT 

NISOPEN 

NISCMD 

NISREAD 

NISWRIT 

NISCLOS 

NSEND 

DELFIL 

TRMNAT 

ERRPRO 


NOT- IN-SET  SORT  ROUTINE 

OPENS  THE  INPUT  AND  OUTPUT  NIS  FILES  ** 

CONTROL  THE  COMPARISON  OF  THE  NIS  FIELDS  ** 
READS  THE  NIS  FILE  AND  CREATE  CHAR  BUFFER  ** 
TO  WRITE  THE  NIS  BUFFER  TO  RESULTS  FILE  ** 
THIS  PROCESS  CLOSES  THE  NIS  FILES  ** 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


CDU01 

AGGREGATOR  UNION  FUNCTION 

VAX- 11  COBOL 

PROGRAM 

CDU01 

.COB 

CDM 

PS41320 


DESCRIPTION: 


THE  OBJECTIVE  OF  THIS  CONFIGURATION  ITEM  IS  TO 
PERFORM  RELATION  UNIONS  UPON  INTERMEDIATE  RESULTS 
OF  A  MULTI -DATABASE  TRASNSACTION .  IT,  ALONG  WITH 
THE  STAGER/ SCHEDULER  Cl  AND  QUERY  PROCESSORS, 

PERFORM  THE  RUN  TIME  EVALUATION  OF  COMMANDS  PRESENTED 
TO  THEM  BY  APPLICATION  PROCESSES. 


THE  UNION  AGGREGATOR  PERFORMS  THE  FOLLOWING: 

1 .  IT  RECEIVES  AND  UNPACKS  A  MESSAGE  FROM  THE  NTM 
AND  BUILDS  APPROPRIATE  TABLES  FOR  THE 

TWO  OPERAND  RELATION  AND  RESULTANT  RELATION. 

2.  IT  PERFORMS  A  SORT/MERGE  OPERATION  ON  THE  OPERAND 
RELATION  CREATING  THE  RESULTANT  RELATION. 

3.  IT  SENDS  A  COMPLETION  MESSAGE  TO  THE  DISTRIBUTED  REQUEST 
SUPERVISOR  WHICH  CONTAINS  PROGRAM  STATUS,  THE  RESULT 

FILE  NAME,  AND  A  RECORD  COUNT  OF  1.  THE  DRS  WILL  COUNT 
THE  NUMBER  OF  RECORDS  BASED  ON  THE  NUMBER  OF  RECORDS  IN 
EACH  INPUT  FILE. 


INCLUDE  FILES: 
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RFTABLE 

AGGMSG 

STDRESP 

ERRCDM 

CHKCDM 

SRVRET 

ERRPRO 


THE  RESULT  FIELD  TABLE 
AGGREGATOR  INPUT  MESSAGE 

WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 
IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
IISS  CDMP  CHECK  STATUS  CODES 
AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


INITAL 

RCV 

SIGERR 

WHTHST 

GENFIL 

SORSPASS  FILES 

SOR$INIT_SORT 

SORS SORT  MERGE 

SOR$ END  SORT 

NSEND 

TRMNAT 

ERRPRO 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


ARGUMENTS : 


POSPAR  -  CHAR 
NEXTREC  -  1*4 
RC  -  1*4 


INCLUDE  FILES: 


HDRINFO . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  HD 
CHD 


ROUTINES  CALLED: 


LIBSINDEX 


CALLED  DIRECTLY  BY: 


CHGPTR 

ADJUST  COMMON  DATA  RECORD  POINTER 

VAX- 11  FORTRAN 

SUBROUTINE 

CHGPTR 

.FOR 

CDM 

PS41320 


GET 


RETRIEVE  CONTENTS  OF  ENTITY  CLASS 


*  t 
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USED  IN  MAIN  PROGRAM(S): 


CDJ01 


AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


CHKRNG 

PERFORM  ATTRIBUTE  VALUE  RANGE  CHECKS 

VAX- 11  FORTRAN 

SUBROUTINE 

CHKRNG 

.FOR 

CDM 

PS41320 


DESCRIPTION: 


ARGUMENTS : 


CHADR  - 

CHAR 

IADRES 

-  1*4 

RADRES 

-  R*4 

CONST  - 

CHAR 

HIVAL  - 

CHAR 

LOVAL  - 

CHAR 

LGTH  - 

1*4 

DTYPE  « 

CHAR 

RC  -  I 

*4 

ROUTINES  CALLED: 


ACTLEN 
CHREAL 
CHRINT 
LIBS INDEX 


DETERMINE  LENGTH  OF  CHARACTER  STRING  ** 

CHARACTER  TO  REAL  CONVERSIONS  ** 

CHARACTER  TO  INTEGER  CONVERSION  ** 


CALLED  DIRECTLY  BY: 


PUTATT  -  DB  AP  USED  TO  INIT/CHANGE  AN  ATT  VALUE  ** 


USED  IN  MAIN  PROGRAM(S) : 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


CHREAL 

CHARACTER  TO  REAL  CONVERSIONS 
VAX- 11  FORTRAN 
SUBROUTINE 
CHREAL 
.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


STRING  -  CHAR 
REALVA  -  R*4 

RC  -  1*4 


ROUTINES  CALLED: 


LIBS INDEX 


CALLED  DIRECTLY  BY: 


ANAVAL 

CHKRNG 

GETITM 


CONVERT  VALUE  OF  ATTRIBUTE  TYPE  *• 
PERFORM  ATTRIBUTE  VALUE  RANGE  CHECKS  »• 
EXTRACT  ATTRIBUTE  VALUE  FROM  USER'S  BUFFER  »* 


USED  IN  MAIN  PROGRAM(S): 


ANAVAL  -  CONVERT  VALUE  OF  ATTRIBUTE  TYPE  •* 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME :  CHRHOL 

PURPOSE :  CONVERT 

LANGUAGE:  VAX- 11 

MODULE  TYPE :  SUBROUT 

SOURCE  FILE:  CHRHOL 

SOURCE  FILE  TYPE:  .FOR 

HOST: 

SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


CHRHOL 

CONVERT  CHAR  STRING  TO  INTEGER  ARRAY 

VAX- 11  FORTRAN 

SUBROUTINE 

CHRHOL 

.FOR 


DESCRIPTION: 


ARGUMENTS : 


STRING  -  CHAR 
INTADD  -  1*4  (1) 

RC  -  1*4 


INCLUDE  FILES: 


MACHDEP . IN  - 


PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

BNFMDP 


CALLED  DIRECTLY  BY: 


ANAVAL 


-  CONVERT  VALUE  OF  ATTRIBUTE  TYPE 


USED  IN  MAIN  PROGRAM ( S ) : 


ANAVAL 


-  CONVERT  VALUE  OF  ATTRIBUTE  TYPE 
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DATA  AGGREGATORS 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


Module  Documentation 


CHRINT 

CHARACTER  TO  INTEGER  CONVERSION 
VAX- 11  FORTRAN 
SUBROUTINE 
CHRINT 
-FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 
DESCRIPTION: 


ARGUMENTS : 


STRING  -  CHAR 
INTGR  -  1*4 

RC  -  1*4 


CALLED  DIRECTLY  BY: 


ANAVAL  -  CONVERT  VALUE  OF  ATTRIBUTE  TYPE  *» 
CHKRNG  -  PERFORM  ATTRIBUTE  VALUE  RANGE  CHECKS  *» 
GETITM  -  EXTRACT  ATTRIBUTE  VALUE  FROM  USER'S  BUFFER  •* 


USED  IN  MAIN  PROGRAM(S) : 


ANAVAL  -  CONVERT  VALUE  OF  ATTRIBUTE  TYPE 

CDJOl  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Nodule  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


CONCAT 

CONCATENATE  TWO  STRINGS 
VAX- 11  FORTRAN 
SUBROUTINE 
CONCAT 
.FOR 

CDM 

PS41320 


DESCRIPTION: 


ARGUMENTS : 


STRING  -  CHAR 
ADDSTR  -  CHAR 


ROUTINES  CALLED: 


ACTLEN 


DETERMINE  LENGTH  OF  CHARACTER  STRING 


$  * 
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DATA  AGGREGATORS  Module  Documentation 


NAME : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


CONDIG 

CONVERTS  SIGN  OF  SIGNED  VALUE  TO  DIGIT 
VAL 

VAX- 11  FORTRAN 

SUBROUTINE 

CONDIG 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


SSIGN  -  CHAR 
SIGN  -  1*4 

DIGIT  -  1*4 

ERROR  »  1*4 


CALLED  DIRECTLY  BY: 

CRTBUF  -  CREATE  CHAR.  STRING  FOR  FIELD  COMPARISON 

USED  IN  MAIN  PROGRAM(S): 

CDN01  -  AGGREGATOR  NOT  IN  SET  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


CRTATR 

POPULATE  ATTRIBUTE  DATA  ITEMS 

VAX- 11  FORTRAN 

SUBROUTINE 

CRTATR 

.FOR 

CDM 

PS41320 


DESCRIPTION: 


ARGUMENTS : 


TYPE  -  CHAR 
ATTR  -  CHAR 
RECNO  -  1*4 

BCHAR  «  1*4 

LCHAR  *  1*4 

SIZE  -  1*4 

NODEC  =  1*4 

CDFLU  *  1*4 

STATUS  *=  1*4 


INCLUDE  FILES: 


ATTRINF . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  »*** 


COMMON  BLOCKS: 

I  ATT 
CATT 


ROUTINES  CALLED: 


WRTATT 


WRITE  ATTRIBUTE  RECORD 


*  * 
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CALLED  DIRECTLY  BY: 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 

USED  IN  MAIN  PROGRAM ( S ) : 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


CRTBUF 

CREATE  CHAR.  STRING 

VAX- 11  FORTRAN 

SUBROUTINE 

CRTBUF 

.FOR 

CDM 

PS41320 


FOR  FIELD  COMPARISON 


ARGUMENTS : 


BUFFER  -  CHAR 
STPOS  -  I *4 
FLDLEN  -  1*4 

NCOMP  -  1*4 

SCOMP  -  R*4 

ERROR  -  1*4 

FLDBUF  -  CHAR 
SIGN  -  1*4 

FLDTYP  -  CHAR 
FIELD  -  1*4 

NODIG  -  1*4 

MODCHK  -  CHAR 


ROUTINES  CALLED: 


CONDIG  -  CONVERTS  SIGN  OF  SIGNED  VALUE  TO  DIGIT  VAL  ** 
NISINT  -  CONVERTS  A  STRING  NUMBER  TO  AN  INTERGER  ** 
NISREL  -  CONVERTS  CHAR  STRING  TO  REAL  VAL  W/NO  DIGIT** 


CALLED  DIRECTLY  BY 


NISCMD  -  CONTROL  THE  COMPARISON  OF  THE  NIS  FIELDS 
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USED  IN  MAIN  PROGRAM(S): 


CDN01  -  AGGREGATOR  NOT  IN  SET  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP 


CRTCDR 

CREATE  THE  RELATIVE 

VAX- 11  FORTRAN 

SUBROUTINE 

CRTCDR 

.FOR 

CDM 

:  PS41320 


ACCESS  FILE  FOR  REL . 


DESCRIPTION: 


ARGUMENTS : 


RELFIL  -  CHAR 
ENTITY  -  CHAR 
CDFLU  -  1*4 

RELLU  -  1*4 

ATRLTH  -  1*4 

RECNO  *  1*4 

STATUS  -  1*4 


INCLUDE  FILEb. 


HDRINFG  IN  -  •••*  PURPOSE  NOT  FOUND  BY  STRIPPER  •••• 


COMMON  BLOCKS . 

I  HD 
CHD 


ROUTINES  CALLED: 


FORSCLOSE 

FORSOPEN 

UPDHDR  -  UPDATE  HEADER  RECORD 

VRTCDR  -  WRITE  CURRENT  RECORD 
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CALLED  DIRECTLY  BY: 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 

USED  IN  MAIN  PROGRAM(S): 

CDJOl  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME  : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


CRTHDR 

CREATE  A  RELATIVE 

VAX- 11  FORTRAN 

SUBROUTINE 

CRTHDR 

.FOR 

CDM 

PS41320 


ADDRESS  FILE  (CDF) 


ARGUMENTS : 

FILNME  - 

CHAR 

ENTITY  - 

CHAR 

RECLTH  = 

1*4 

ATRLTH  = 

1*4 

NOATTR  = 

1*4 

CDFLU  = 

1*4 

STATUS  - 

1*4 

INCLUDE  FILES: 


HDRINFO . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  HD 
CHD 


ROUTINES  CALLED: 


FORSOPEN 

WRTHDR  -  WRITE  RECORD  HEADER 
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CALLED  DIRECTLY  BY: 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 

USED  IN  MAIN  PROGRAM(S) : 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


FORCLS 

CLOSE  ALL  FILES  USED  BY  THE  AGGREGATORS 

VAX- 11  FORTRAN 

SUBROUTINE 

FORCLS 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 

CDFLU1  - 

1*4 

CDFLU2  - 

1*4 

CDFLU3  * 

1*4 

STATUS  - 

1*4 

ROUTINES  CALLED: 


FORSCLOSE 


CALLED  DIRECTLY  BY: 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 


USED  IN  MAIN  PROGRAM ( S ) : 

CD.  01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


GACHX 

CHECK  INPUT  PARAMETERS  OF  GET ATT'  CALL 


VAX- 11  FORTRAN 

SUBROUTINE 

GACHX 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


ENTITY  -  1*4 

CDFLU  -  1*4 

ATT1  -  1*4 

LAS ATT  -  1*4 

ATTR  -  1*4 

RC  -  1*4 

CHADRS  -  CHAR 


INCLUDE  FILES: 


ATTRINF . IN  -  ••••  PURPOSE  NOT  FOUND  BY  STRIPPER  •••• 


COMMON  BLOCKS: 

I  ATT 
CATT 


ROUTINES  CALLED: 

GAINFO  -  STORE  ATTRIBUTE  INFORMATION  IN  COMMON  BLOCK** 


CALLED  DIRECTLY  BY: 
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GETATT  -  RETRIEVE  ATTRIBUTE  INFORMATION 

USED  IN  MAIN  PROGRAM(S): 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


GAINFO 

STORE  ATTRIBUTE  INFORMATION  IN  COMMON 
BLOCK 

VAX- 11  FORTRAN 

SUBROUTINE 

GAINFO 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


ATT1  -  1*4 

LAS ATT  -  1*4 

CDFLU  -  1*4 

ATTR  -  CHAR 
RC  -  1*4 

RECADR  -  1*4 


INCLUDE  FILES: 


ATTRINF . IN  -  •••*  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  ATT 
CATT 


CALLED  DIRECTLY  BY: 


ANAATT  -  DETERMINE  LEGALITY  OF  ATTRIBUTE  NAME 

AMAVAL  -  CONVERT  VALUE  OF  ATTRIBUTE  TYPE 
GACHX  -  CHECK  INPUT  PARAMETERS  OF  GET ATT'  CALL 

PACHX  -  CHECK  THE  PARAMETERS  OF  THE  PUTATT  CALL 
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SACHK  -  SORTING  THE  ATTRIBUTE  RECORDS 


USED  IN  MAIN  PROGRAM(S) : 


ANAATT 

ANAVAL 

CDJ01 


DETERMINE  LEGALITY  OF  ATTRIBUTE  NAME 
CONVERT  VALUE  OF  ATTRIBUTE  TYPE 
AGGREGATOR  JOIN  FUNCTION 


*  * 
*  * 
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DATA  AGGREGATORS  Module  Documentation 


NAME :  GET 

PURPOSE:  RETRIEVE  CONTENTS  OF  ENTITY  CLASS 

LANGUAGE:  VAX- 11  FORTRAN 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE:  GET 

SOURCE  FILE  TYPE:  .FOR 

HOST: 

SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41320 
DESCRIPTION: 


ARGUMENTS : 


ENTITY  -  CHAR 
POSPAR  -  CHAR 
CDFLU  -  1*4 

BUFFER  -  CHAR 
RC  -  1*4 


INCLUDE  FILES: 


HDRINFO . IN  -  ***•  PURPOSE  NOT  FOUND  BY  STRIPPER 


COMMON  BLOCKS: 

I  HD 
CHD 


ROUTINES  CALLED: 


CHGPTR  -  ADJUST  COMMON  DATA  RECORD  POINTER  •• 
FOR* INQUIRE 

GETCHK  -  CHECK  INPUT  PARAMETERS  OF  GET  FOR  ERRORS  •• 
GETPTR  -  DETERMINE  NEXT  CURRENT  RECORD  POINTER  •• 
RDCDR  -  RETURN  THE  CONTENTS  OF  A  COMMON  DATA  RECORD* * 
RDHDR  -  READ  HEADER  RECORD  TO  DETERMINE  PROCESSING  ** 
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WRTHDR  -  WRITE  RECORD  HEADER 


CALLED  DIRECTLY  BY: 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 

GETREL  -  RETRIEVE  THE  NEXT  RECORD  FROM  THE  CDF  FILE  ** 


USED  IN  MAIN  PROGRAM(S) : 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


GETATT 

RETRIEVE  ATTRIBUTE  INFORMATION 

VAX- 11  FORTRAN 

SUBROUTINE 

GETATT 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


ENTITY  -  CHAR 
ATTR  -  CHAR 
CDFLU  -  1*4 

BUFFER  -  CHAR 
CHADR  -  CHAR 
IADRES  -  1*4 

RADRES  -  1*4 

TYPE  -  CHAR 
SIZE  -  1*4 

DECMAL  «  1*4 

RC  -  1*4 


INCLUDE  FILES: 


HDRINFO . IN  - 
ATTRINF . IN  - 


*•**  PURPOSE 
*••*  PURPOSE 


NOT  FOUND  BY 
NOT  FOUND  BY 


STRIP1FR  **•» 
STRIPPER  **•• 


COMMON  BLOCKS: 

I  HD 
CHD 
I  ATT 
CATT 
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ROUTINES  CALLED: 


FOR $  INQUIRE 

GACHK  -  CHECK  INPUT  PARAMETERS  OF  ' GETATT '  CALL  ** 
GETITM  -  EXTRACT  ATTRIBUTE  VALUE  FROM  USER'S  BUFFER  ** 
RDHDR  -  READ  HEADER  RECORD  TO  DETERMINE  PROCESSING  ** 


CALLED  DIRECTLY  BY: 


GETFLD  -  RETRIEVE  AN  ATTRIBUTE  FROM  A  RECORD 


USED  IN  MAIN  PROGRAM ( S ) : 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST : 


GETCHK 

CHECK  INPUT  PARAMETERS  OF  GET'  FOR 
ERRORS 

VAX- 11  FORTRAN 

SUBROUTINE 

GETCHK 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


CDFLU  «  1*4 

POSPAR  -  CHAR 
BUFFER  -  CHAR 
RC  *  1*4 


INCLUDE  FILES: 


HDRINFO . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  •»** 


COMMON  BLOCKS: 

I  HD 
CHD 


ROUTINES  CALLED: 
LIBS INDEX 


CALLED  DIRECTLY  BY: 


GET  -  RETRIEVE  CONTENTS  OF  ENTITY  CLASS 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


GETFLD 

RETRIEVE  AN  ATTRIBUTE  FROM  A  RECORD 

VAX- 11  FORTRAN 

SUBROUTINE 

GETFLD 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


ENTITY  -  CHAR 
ATTR  -  CHAR 
BUFFER  -  CHAR 
CADRES  -  CHAR 
TYPE  -  CHAR 
CDFLU  -  1*4 

IADRES  -  1*4 

RADRES  -  R*4 

SIZE  -  1*4 

NODEC  -  1*4 

STATUS  -  1*4 


ROUTINES  CALLED: 

GETATT  -  RETRIEVE  ATTRIBUTE  INFORMATION 

CALLED  DIRECTLY  BY: 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 


USED  IN  MAIN  PROGRAM ( S ) : 
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CDJ01  -  AGGREGATOR  JOIN  FUNCTION 


3-86 


PS  620141320 
1  November  1985 


DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


GETITM 

EXTRACT  ATTRIBUTE 
BUFFER 

VAX- 11  FORTRAN 
SUBROUTINE 
GETITM 
•  FOR 

CDM 

PS41320 


VALUE  FROM  USER'S 


ARGUMENTS : 


BUFFER  -  CHAR 
BC  -  1*4 

LC  -  1*4 

TYPE  -  CHAR 
SIZE  -  1*4 

DECDIG  -  1*4 

CHADRS  -  CHAR 
IADRS  -  1*4 

RADRES  -  R*4 

RC  -  1*4 


ROUTINES  CALLED: 


CHREAL  -  CHARACTER  TO  REAL  CONVERSIONS 
CHRINT  -  CHARACTER  TO  INTEGER  CONVERSION 


CALLED  DIRECTLY  BY: 


GETATT  -  RETRIEVE  ATTRIBUTE  INFORMATION 


USED  IN  MAIN  PROGRAM(S): 
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-  AGGREGATOR  JOIN  FURCTZOM 
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MAKE : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


GETPTR 

DETERMINE  NEXT  CURRENT  RECORD  POINTER 

VAX- 11  FORTRAN 

SUBROUTINE 

GETPTR 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


REC1  -  1*4 

CURREC  -  1*4 

NEXTREC  -  1*4 

LASREC  -  1*4 

POSPAR  -  CHAR 
RC  -  1*4 


ROUTINES  CALLED: 


LI B$ INDEX 


CALLED  DIRECTLY  BY: 

GET  -  RETRIEVE  CONTENTS  OF  ENTITY  CLASS 

USED  IN  MAIN  PROGRAM(S): 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


GETREL 

RETRIEVE  THE  NEXT  RECORD  FROM  THE  CDF 
FILE 

VAX- 11  FORTRAN 

SUBROUTINE 

GETREL 

-FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


ENTITY  -  CHAR 
BUFFER  -  CHAR 
CDFLU  -  1*4 

STATUS  -  1*4 


ROUTINES  CALLED: 

GET  -  RETRIEVE  CONTENTS  OF  ENTITY  CLASS 

CALLED  DIRECTLY  BY: 

CDJOl  -  AGGREGATOR  JOIN  FUNCTION 

USED  IN  MAIN  PROGRAM ( S ) : 

CDJOl  -  AGGREGATOR  JOIN  FUNCTION 
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NAME :  HOLCHR 

PURPOSE:  CONVERT  DATA  FROM  HOLLERITH  TO  CHARACTER 

LANGUAGE:  VAX- 11  FORTRAN 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE :  HOLCHR 

SOURCE  FILE  TYPE:  .FOR 

HOST: 

SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41320 
DESCRIPTION: 


ARGUMENTS : 


INTADD  -  1*4  (1) 

STRING  -  CHAR 
RC  -  1*4 


INCLUDE  FILES: 


MACHDEP . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

BNFMDP 
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DATA  AGGREGATORS 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


Module  Documentation 


INTCHR 

CONVERT  INTEGER  VALUE  TO  CHARACTER  STRING 

VAX- 11  FORTRAN 

SUBROUTINE 

INTCHR 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


INTGR  -  1*4 

SIZE  -  1*4 

STRING  -  CHAR 
RC  «  1*4 


CALLED  DIRECTLY  BY: 

PUTITM  -  CONVERTS  VAL  SUPPLIED  AND  STORES  IN  BUFFER  ** 

USED  IN  MAIN  PROGRAM(S) : 

CDJOl  -  AGGREGATOR  JOIN  FUNCTION 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


ARGUMENTS : 


CDFLU  -  1*4 

RC  -  1*4 

KEYBUF  -  1*2  (41) 

TOTKEY  -  1*2 


INCLUDE  FILES: 


HDRINFO . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  ••»* 
ATTRINF . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  •••• 


INTSRT 

FILL  KEY  ARRAY  USED  BY  THE  VAX  SORT 
ROUTINE 

VAX- 11  FORTRAN 

SUBROUTINE 

INTSRT 

-FOR 

CDM 

PS41320 


COMMON  BLOCKS: 

I  HD 
CHD 
I  ATT 
CATT 


ROUTINES  CALLED: 


SORSINITSORT 

WRTATT  -  WRITE  ATTRIBUTE  RECORD 


v.v’wsw;* 
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N1SCLOS 

THIS  PROCESS  CLOSES  THE  NIS  FILES 
VAX- 11  FORTRAN 
SUBROUTINE 
MISCLOS 
FOR 

CDM 

PS41320 

DESCRIPTION : 


ARGUMENTS : 

FILNAM  - 

CHAR 

UNITNO  - 

1*4 

FILSTS  - 

CHAR 

CLSERR  - 

1*4 

ROUTINES  CALLED: 


FORSCLOSE 

CALLED  DIRECTLY  BY: 


NAME 
PURPOSE 
LANGUAGE 
MODULE  TYPE 
SOURCE  f* 

SOURCE  t  S 

HOST 

SUBSYSTER 
SUBDIRECTORY 
DOCUMENTATION  GROUP: 


CDN01  -  AGGREGATOR  NOT  IN  SET  FUNCTION 


USED  IN  MAIN  PROGRAM(S): 

CDN01  -  AGGREGATOR  NOT  IN  SET  FUNCTION 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


NISCMD 

CONTROL  THE  COMPARISON  OF  THE  NIS  FIELDS 

VAX- 11  FORTRAN 

SUBROUTINE 

NISCMD 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


F1BUF  - 

CHAR 

F2BUF  - 

CHAR 

NISCON  - 

1*4 

POS1  - 

1*4 

LG1  »  I 

*4 

TYPE1  * 

CHAR 

NODIG1  - 

1*4 

ATTR1  « 

1*4 

POS2  « 

1*4 

LG2  -  I 

*4 

TYPE2  - 

CHAR 

NODIG2  - 

1*4 

ATTR2  > 

1*4 

FI ERR  - 

1*4 

F2ERR  « 

1*4 

INDEX  - 

1*4 

CHECK  - 

CHAR 

ROUTINES  CALLED: 


CRTBUF  -  CREATE  CHAR.  STRING  FOR  FIELD  COMPARISON  •* 
NISINT  -  CONVERTS  A  STRING  NUMBER  TO  AN  INTERGER  *• 
NISREL  -  CONVERTS  CHAR  STRING  TO  REAL  VAL  W/NO  DIGIT** 
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CALLED  DIRECTLY  BY: 

CDN01  -  AGGREGATOR  NOT  IN  SET  FUNCTION 

USED  IN  MAIN  PROGRAM(S) : 

CDNOl  -  AGGREGATOR  MOT  IN  SET  FUNCTION 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


NISINT 

CONVERTS  A  STRING  NUMBER  TO  AN  INTERGER 

VAX- 11  FORTRAN 

SUBROUTINE 

NISINT 

.FOR 

CDM 

PS41320 


DESCRIPTION: 


ARGUMENTS : 


STRING  -  CHAR 
INTGR  «  1*4 

RC  *  1*4 

ILEN  -  1*4 


CALLED  DIRECTLY  BY: 


CRTBUF  -  CREATE  CHAR.  STRING  FOR  FIELD  COMPARISON 

NISCMD  -  CONTROL  THE  COMPARISON  OF  THE  NIS  FIELDS 


USED  IN  MAIN  PROGRAM(S) : 


CDN01  -  AGGREGATOR  NOT  IN  SET  FUNCTION 
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NAME: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


N ISOPEN 

OPENS  THE  INPUT  AND  OUTPUT  NIS  FILES 

VAX- 11  FORTRAN 

SUBROUTINE 

NISOPEN 

-FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 

FILNAM  - 

CHAR 

UNITNO  - 

1*4 

FILSTS  - 

CHAR 

RECLEN  - 

1*4 

OPERR  - 

1*4 

ROUTINES  CALLED: 

FOR$OPEN 

CALLED  DIRECTLY  BY: 

CDN01  -  AGGREGATOR  NOT  IN  SET  FUNCTION 

USED  IN  MAIN  PROGRAM(S): 

CDN01  -  AGGREGATOR  NOT  IN  SET  FUNCTION 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP. 


NISREAD 

READS  THE  NIS  FILE  AND  CREATE  CHAR 
BUFFER 

VAX- 11  FORTRAN 

SUBROUTINE 

NISREAD 

.FOR 

CDM 

PS41320 


DESCRIPTION: 


ARGUMENTS : 


BUFFER  -  CHAR 
UNITNO  -  1*4 

RDERR  -  1*4 

RECSIZE  -  1*4 

FILEOF  -  1*4 


CALLED  DIRECTLY  BY: 


CDN01 

-  AGGREGATOR 

NOT 

IN 

SET 

FUNCTION 

USED  IN  MAIN 

PROGRAM ( S ) : 

CDN01 

-  AGGREGATOR 

NOT 

IN 

SET 

FUNCTION 
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NAME : 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


NISREL 

CONVERTS  CHAR  STRING  TO  REAL  VAL  W/NO 
DIGIT 

VAX- 11  FORTRAN 

SUBROUTINE 

NISREL 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


STRING  -  CHAR 
REALVA  -  R*4 

ILEN  «  1*4 

NODIG  -  1*4 

RC  -  1*4 


CALLED  DIRECTLY  BY: 


CRTBUF  -  CREATE  CHAR.  STRING  FOR  FIELD  COMPARISON  •* 

NISCMD  -  CONTROL  THE  COMPARISON  OF  THE  NIS  FIELDS  *• 


USED  IN  MAIN  PROGRAM(S) : 


CDN01  -  AGGREGATOR  NOT  IN  SET  FUNCTION 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


NISSORT 

NOT- IN -SET  SORT  ROUTINE 

VAX- 11  COBOL 

SUBROUTINE 

NISSORT 

-COB 

CDM 

PS41320 


THE  OBJECTIVE  OF  THIS  CONFIGURATION  ITEM  IS  TO 
SORT  THE  INPUT  FILE  THAT  MEETS  THE  QUALIFICATIONS 
OF  THE  RECORD  "INPUT-FILE". 


REVISED  15  APR  1985 
MODIFIED  2  MAY  1985 
MODIFIED  9  MAY  1985 


ARGUMENTS : 


INPUT-FILE  -  RE CRD 
TEMP-FILE-NAME  -  DSPLY  [X(30)J 
MESG-DESC  -  DSPLY  [X(60)3 
RET-STATUS  -  DSPLY  [ X( 5 ) ] 


INCLUDE  FILES: 


ERRCDM  -  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


SORSPASSFILES 
SORJINIT  SORT 
SORS SORT  MERGE 
SORSEND  SORT 
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ERRPRO 

CALLED  DIRECTLY  BY: 

CDN01  -  AGGREGATOR  NOT  IN  SET  FUNCTION 

USED  IN  MAIN  PROGRAM ( S ) : 

CDN01  -  AGGREGATOR  NOT  IN  SET  FUNCTION 
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NISWRIT 

TO  WRITE  THE  NIS  BUFFER  TO  RESULTS  FILE 
VAX- 11  FORTRAN 
SUBROUTINE 
NISWRIT 
•  FOR 

CDM 

PS41320 

DESCRIPTION : 


ARGUMENTS : 

UNITNO  - 

1*4 

BUFFER  = 

CHAR 

WRTERR  « 

1*4 

RECSIZ  = 

1*4 

CALLED  DIRECTLY  BY: 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


CDN01 

-  AGGREGATOR 

NOT 

IN 

SET 

FUNCTION 

USED  IN  MAIN 

PROGRAM ( S ) : 

CDN01 

-  AGGREGATOR 

NOT 

IN 

SET 

FUNCTION 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


PACHK 

CHECK  THE  PARAMETERS  OF  THE  PUTATT  CALL 
VAX- 11  FORTRAN 
SUBROUTINE 
PACHK 
.FOR 

CDM 

PS41320 


DESCRIPTION: 


ARGUMENTS : 


ENTITY  -  CHAR 
CDFLU  -  1*4 

ATT1  -  1*4 

LAS ATT  .  1*4 

ATTR  -  CHAR 
RC  -  1*4 

CHADR  -  CHAR 


INCLUDE  FILES: 


ATTRINF . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  ATT 
CATT 


ROUTINES  CALLED: 


GAINFO  -  STORE  ATTRIBUTE  INFORMATION  IN  COMMON  BLOCK** 


CALLED  DIRECTLY  BY: 


»3£i&S£. 


PS  620141320 
1  November  1985 


PUTATT  -  DB  AP  USED  TO  INIT/CHANGE  AN  ATT  VALUE 

USED  IN  MAIN  PROGRAM ( S ) : 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 


1 


PS  620141320 
1  November  1985 


DATA  AGGREGATORS  Module  Documentation 


NAME: 

PUTATT 

PURPOSE : 

DB  AP  USED  TO  INIT/CHANGE  AN  ATT  VALUE 

LANGUAGE : 

VAX- 11  FORTRAN 

MODULE  TYPE : 

SUBROUTINE 

SOURCE  FILE: 

PUTATT 

SOURCE  FILE  TYPE: 

.FOR 

HOST: 

SUBSYSTEM : 

CDM 

SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

PS41320 

DESCRIPTION: 


ARGUMENTS 

ENTITY 

-  CHAR 

ATTR  - 

CHAR 

CDFLU  - 

1*4 

CHADR  - 

CHAR 

IADRES 

-  1*4 

RADRES 

-  R*4 

BUFFER 

-  CHAR 

RC  -  I 

*4 

INCLUDE  FILES: 

HDRINFO . IN  -  ***»  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
ATTRINF . IN  -  *••*  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  HD 
CHD 
I  ATT 
CATT 


ROUTINES  CALLED: 
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CHKRNG  -  PERFORM  ATTRIBUTE  VALUE  RANGE  CHECKS  ** 
FORS INQUIRE 

PACHK  -  CHECK  THE  PARAMETERS  OF  THE  PUTATT  CALL  ** 
PUTITM  -  CONVERTS  VAL  SUPPLIED  AND  STORES  IN  BUFFER  ** 
RDHDR  -  READ  HEADER  RECORD  TO  DETERMINE  PROCESSING  ** 


CALLED  DIRECTLY  BY: 


CDJOl  -  AGGREGATOR  JOIN  FUNCTION 


USED  IN  MAIN  PROGRAM ( S ) : 


CDJOl  -  AGGREGATOR  JOIN  FUNCTION 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


PUTITM 

CONVERTS  VAL  SUPPLIED  AND  STORES  IN 
BUFFER 

VAX- 11  FORTRAN 

SUBROUTINE 

PUTITM 

.FOR 

CDM 

PS41320 


DESCRIPTION: 


ARGUMENTS : 


CHADRS  -  CHAR 
IADRS  -  1*4 

RADRS  -  R*4 

BC  «  1*4 

LC  -  1*4 

TYPE  -  CHAR 
SIZE  -  1*4 

DECDIG  -  1*4 

BUFFER  -  CHAR 
RC  -  1*4 


ROUTINES  CALLED: 

INTCHR  -  CONVERT  INTEGER  VALUE  TO  CHARACTER  STRING  ** 

REALCH  -  CONVERT  REAL  NUMBER  TO  CHARACTER  STRING  ** 

CALLED  DIRECTLY  BY: 

PUTATT  -  DB  AP  USED  TO  INIT/CHANGE  AN  ATT  VALUE  ** 

USED  IN  MAIN  PROGRAM ( S ) : 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


ARGUMENTS : 


RESNME  -  CHAR 
ENTITY  -  CHAR 
CDFLU  -  1*4 

RELLU  -  1*4 

RECCNT  -  1*4 

STATUS  -  1*4 


INCLUDE  FILES: 


HDRINFO. IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  HD 
CHD 


ROUTINES  CALLED: 


FOR$CLOSE 

FORSOPEN 

I  RDCDR 

|  RDHDR 

|  WRTREL 


-  RETURN  THE  CONTENTS  OF  A  COMMON  DATA  RECORD** 

-  READ  HEADER  RECORD  TO  DETERMINE  PROCESSING  ** 

-  WRITE  A  RECORD  TO  THE  RESULT  FILE  ** 


RDCDFR 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

VAX- 11  FORTRAN 

SUBROUTINE 

RDCDFR 

.FOR 

CDM 

PS41320 
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DATA  AGGREGATORS 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


Module  Documentation 


RDCDR 

RETURN  THE  CONTENTS  OF  A  COMMON  DATA 
RECORD 

VAX- 11  FORTRAN 

SUBROUTINE 

RDCDR 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


CDFLU  -  1*4 

NEXTREC  -  1*4 

RECSIZ  «  1*4 

BUFFER  -  CHAR 
UPDFLG  =  CHAR 
DELFLG  =  L*4 


CALLED  DIRECTLY  BY: 


GET  -  RETRIEVE  CONTENTS  OF  ENTITY  CLASS  ** 

RDCDFR  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

RDRSFL  -  WRITE  THE  RELATIVE  FILE  TO  JOIN  RESULT  FILE** 

SRTCDR  -  SORTING  THE  COMMON  DATA  RECORD  ** 


USED  IN  MAIN  PROGRAM ( S ) : 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 

RDCDFR  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
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NAME: 
PURPOSE : 


LANGUAGE:  VAX- 11 

MODULE  TYPE :  SUBROUT 

SOURCE  FILE:  RDHDR 

SOURCE  FILE  TYPE:  .FOR 

HOST: 

SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41320 
DESCRIPTION: 


RDHDR 

READ  HEADER  RECORD  TO  DETERMINE 

PROCESSING 

VAX- 11  FORTRAN 

SUBROUTINE 

RDHDR 

.FOR 


ARGUMENTS : 


CDFLU  -  1*4 

ENTITY  -  CHAR 
RC  -  1*4 


INCLUDE  FILES: 


HDRINFO. IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  HD 
CHD 


CALLED  DIRECTLY  BY: 


GET 

GETATT 

PUTATT 

RDCDFR 

RDRSFL 

SORT 

SRTATT 


-  RETRIEVE  CONTENTS  OF  ENTITY  CLASS  »* 

-  RETRIEVE  ATTRIBUTE  INFORMATION  ** 

-  DB  AP  USED  TO  INIT/CHANGE  AN  ATT  VALUE  ** 

-  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  ***» 

-  WRITE  THE  RELATIVE  FILE  TO  JOIN  RESULT  FILE** 

-  SORTING  A  FILE  ** 

-  STORE  THE  SORTING  CRITERIA  FOR  A  SINGLE 
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ATTRIBUTE 

UPDHDR  -  UPDATE  HEADER  RECORD 


USED  IN  MAIN  PROGRAM ( S ) : 


•  * 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 

RDCDFR  -  ***♦  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


I 
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RDRSFL 

WRITE  THE  RELATIVE  FILE  TO  JOIN  RESULT 
FILE 

VAX- 11-  FORTRAN 
SUBROUTINE 
RDRSFL 
.FOR 

CDM 

PS41320 

DESCRIPTION: 


ARGUMENTS : 


RESNME  -  CHAR 
ENTITY  -  CHAR 
CDFLU  -  1*4 

RELLU  «  1*4 

RECCNT  -  1*4 

STATUS  -  1*4 


INCLUDE  FILES: 


HDRINFO . IN  -  ••*•  PURPOSE  NOT  FOUND  BY  STRIPPER  **•• 


COMMON  BLOCKS: 

I  HD 
CHD 


ROUTINES  CALLED: 


FOR$CLOSE 

FORSOPEN 

RDCDR  -  RETURN  THE  CONTENTS  OF  A  COMMON  DATA  RECORD** 

RDHDR  -  READ  HEADER  RECORD  TO  DETERMINE  PROCESSING  •• 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 
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WRTREL  -  WRITE  A  RECORD  TO  THE  RESULT  FILE 

CALLED  DIRECTLY  BY: 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 

USED  IN  MAIN  PROGRAM(S) : 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 


REALCH 

CONVERT  REAL  NUMBER 
VAX- 11  FORTRAN 
SUBROUTINE 
REALCH 
.FOR 

CDM 

:  PS41320 


TO  CHARACTER  STRING 


DESCRIPTION 

: 

ARGUMENTS : 

REALNO  - 

R*4 

TOTDIG  - 

1*4 

DECDIG  - 

1*4 

STRING  - 

CHAR 

RC  -  1*4 

CALLED  DIRECTLY  BY: 

PUTITM  -  CONVERTS  VAL  SUPPLIED  AND  STORES  IN  BUFFER  ** 

USED  IN  MAIN  PROGRAM ( S ) : 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


RELFTN 

CONVERT  REAL  NUMBER  TO  CHARACTER  STRING 

VAX- 11  FORTRAN 

SUBROUTINE 

RELFTN 

.FOR 


HOST: 

SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


DECMAL  -  I *4 
REALIN  =  R*8 

CHAROT  -  CHAR 


l 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


RETCDR 

SORTING  AND  WRITE  RECORD 

VAX- 11  FORTRAN 

SUBROUTINE 

RETCDR 

.FOR 


HOST: 

SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


CDFLU  -  1*4 

RECREL  -  1*4 

TOTKEY  -  1*2 

RC  -  1*4 


INCLUDE  FILES: 


HDRINFO . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  HD 
CHD 


ROUTINES  CALLED: 


SORSRETURNREC 

WRTCDR  -  WRITE  CURRENT  RECORD 


CALLED  DIRECTLY  BY: 


SORT  -  SORTING  A  FILE 
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USED  IN  MAIN  PROGRAM (S ) : 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


SACHK 

SORTING  THE  ATTRIBUTE  RECORDS 

VAX- 11  FORTRAN 

SUBROUTINE 

SACHK 

.FOR 


HOST: 

SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


ENTITY  -  CHAR 
ATTR  -  CHAR 
CDFLU  -  1*4 

ORDER  -  CHAR 
RC  *  1*4 

RECADR  -  1*4 


INCLUDE  FILES: 


HDRINFO. IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **•• 
ATTRINF. IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  •*** 


COMMON  BLOCKS: 

I  HD 
CHD 
I  ATT 
CATT 


ROUTINES  CALLED: 


GAINFO  -  STORE  ATTRIBUTE  INFORMATION  IN  COMMON  BLOCK** 

WRTATT  -  WRITE  ATTRIBUTE  RECORD  ** 
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CALLED  DIRECTLY  BY: 


SRTATT  -  STORE  THE  SORTING  CRITERIA  FOR  A  SINGLE 

ATTRIBUTE 

USED  IN  MAIN  PROGRAM(S): 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


SORT 

SORTING  A  FILE 
VAX- 11  FORTRAN 
SUBROUTINE 
SORT 
.FOR 

CDM 


HOST: 

SUBSYSTEM : 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


ENTITY  -  CHAR 
CDFLU  -  1*4 

RC  *  1*4 


INCLUDE  FILES: 


HDRINFO . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  HD 
CHD 


ROUTINES  CALLED: 


FORS INQUIRE 

INTSRT 

RDHDR 

RETCDR 

SRTCDR 

TRMSRT 


FILL  KEY  ARRAY  USED  BY  THE  VAX  SORT  ROUTINE** 
READ  HEADER  RECORD  TO  DETERMINE  PROCESSING  ** 
SORTING  AND  WRITE  RECORD  ** 
SORTING  THE  COMMON  DATA  RECORD  ** 
TERMINATE  THE  SORTING  ** 
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CALLED  DIRECTLY  BY: 


CDJ01 


-  AGGREGATOR  JOIN  FUNCTION 


USED  IN  MAIN  PROGRAM(S) : 


CDJ01 


-  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


SRTATT 

STORE  THE  SORTING  CRITERIA  FOR  A  SINGLE 

ATTRIBUTE 

VAX- 11  FORTRAN 

SUBROUTINE 

SRTATT 

.FOR 

CDM 

PS41320 


DESCRIPTION: 


ARGUMENTS : 


ENTITY  -  CHAR 
ATTR  -  CHAR 
CDFLU  -  1*4 

ORDER  -  CHAR 
RC  -  1*4 


INCLUDE  FILES: 


HDRINFO . IN  -  **•*  PURPOSE  NOT  FOUND  BY  STRIPPER  ***• 


COMMON  BLOCKS: 

I  HD 
CHD 


ROUTINES  CALLED: 


ADDCHN  -  ADD  ATTRIBUTE  TO  LINKED  LIST  ** 

FORI INQUIRE 

RDHDR  -  READ  HEADER  RECORD  TO  DETERMINE  PROCESSING  ** 

SACHX  -  SORTING  THE  ATTRIBUTE  RECORDS  * 
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CALLED  DIRECTLY  BY: 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 

USED  IN  MAIN  PROGRAM(S): 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


SRTCDR 

SORTING  THE  COMMON  DATA  RECORD 

VAX- 11  FORTRAN 

SUBROUTINE 

SRTCDR 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


CDFLU  -  1*4 

KEYBUF  -  1*2  (41) 

TOTKEY  -  1*2 

REC1  -  1*4 

LASREC  -  1*4 

NUMREC  ■=  1*4 

RECSIZ  =  1*4 

RECREL  •=  1*4 

RC  *•  1*4 


ROUTINES  CALLED: 


RDCDR  -  RETURN  THE  CONTENTS  OF  A  COMMON  DATA  RECORD** 

SOR$RELEASE_REC 

SORJSORT  MERGE 


CALLED  DIRECTLY  BY: 


SORT  -  SORTING  A  FILE 


USED  IN  MAIN  PROGRAM (S ) : 
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CDJ01 


I 


-  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


TRMSRT 

TERMINATE  THE  SORTING 

VAX- 11  FORTRAN 

SUBROUTINE 

TRMSRT 

.FOR 

CDM 

PS41320 


l 


ARGUMENTS : 


CDFLU  -  1*4 

RC  -  1*4 


INCLUDE  FILES: 


HDRINFO . IN  -  »***  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  HD 
CHD 


ROUTINES  CALLED: 


SORSENDSORT 

WRTHDR  -  WRITE  RECORD  HEADER 


CALLED  DIRECTLY  BY: 


SORT  -  SORTING  A  FILE 
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USED  IN  MAIN  PROGRAM(S) : 
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CDJ01 


-  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


UPDHDR 

UPDATE  HEADER  RECORD 
VAX- 11  FORTRAN 
SUBROUTINE 
UPDHDR 
•  FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


ENTITY  -  CHAR 
CDFLU  -  1*4 

RECNO  -  1*4 

RECCNT  -  1*4 

STATUS  -  1*4 


INCLUDE  FILES: 


HDRINFO . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  HD 
CHD 


ROUTINES  CALLED: 


RDHDR  -  READ  HEADER  RECORD  TO  DETERMINE  PROCESSING  ** 

WRTHDR  -  WRITE  RECORD  HEADER  ** 


CALLED  DIRECTLY  BY: 
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CDJ01 

CRTCDR 


USED  IN  MAIN 


CDJ01 


-  AGGREGATOR  JOIN  FUNCTION 

-  CREATE  THE  RELATIVE  ACCESS  FILE  FOR  REL. 
PROGRAM ( S ) : 

-  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


WRTATT 

WRITE  ATTRIBUTE  RECORD 

VAX- 11  FORTRAN 

SUBROUTINE 

WRTATT 

-FOR 

CDM 

PS41320 


ARGUMENTS : 


CDFLU  -  1*4 

RECADR  -  1*4 


INCLUDE  FILES: 


ATTRINF . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  ATT 
CATT 


CALLED  DIRECTLY  BY: 


ADDCHN  -  ADD  ATTRIBUTE  TO  LINKED  LIST  »* 
CRTATR  -  POPULATE  ATTRIBUTE  DATA  ITEMS  ** 
INTSRT  -  FILL  KEY  ARRAY  USED  BY  THE  VAX  SORT  ROUTINE** 
SACHK  -  SORTING  THE  ATTRIBUTE  RECORDS  * 


USED  IN  MAIN  PROGRAM ( S ) : 


CDJ01 


AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


WRTCDR 

WRITE  CURRENT  RECORD 

VAX- 11  FORTRAN 

SUBROUTINE 

WRTCDR 

.FOR 

CDM 

PS41320 


ARGUMENTS : 


CDFLU  -  1*4 

CURREC  -  1*4 

RECSIZ  -  1*4 

BUFF  -  CHAR 
UPDFLG  -  CHAR 


CALLED  DIRECTLY  BY: 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 

CRTCDR  -  CREATE  THE  RELATIVE  ACCESS  FILE  FOR  REL. 

RETCDR  -  SORTING  AND  WRITE  RECORD 


USED  IN  MAIN  PROGRAM ( S ) : 


CDJ01 


AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


WRTHDR 

WRITE  RECORD  HEADER 

VAX- 11  FORTRAN 

SUBROUTINE 

WRTHDR 

-FOR 

CDM 

PS41320 


ARGUMENTS : 

CDFLU  -  1*4 


INCLUDE  FILES: 


HDRINFO . IN  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


COMMON  BLOCKS: 

I  HD 
CHD 


CALLED  DIRECTLY  BY: 


ADDCHN  -  ADD  ATTRIBUTE  TO  LINKED  LIST 

CRTHDR  -  CREATE  A  RELATIVE  ADDRESS  FILE  (CDF) 

GET  -  RETRIEVE  CONTENTS  OF  ENTITY  CLASS 

TRMSRT  -  TERMINATE  THE  SORTING 

UPDHDR  -  UPDATE  HEADER  RECORD 


USED  IN  MAIN  PROGRAM ( S ) : 

CDJ01  -  AGGREGATOR  JOIN  FUNCTION 
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DATA  AGGREGATORS  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  PILE: 
SOURCE  FILE  TYPE: 
HOST: 


WRTREL 

WRITE  A  RECORD  TO  THE  RESULT  FILE 

VAX- 11  FORTRAN 

SUBROUTINE 

WRTREL 

.FOR 


SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41320 


DESCRIPTION: 


ARGUMENTS : 


RELLU  -  1*4 

BUFFER  -  CHAR 
RECSIZ  -  1*4 

RC  *  1*4 


CALLED  DIRECTLY  BY: 


RDCDFR  -  •***  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

RDRSFL  -  WRITE  THE  RELATIVE  FILE  TO  JOIN  RESULT  FILE** 


USED  IN  MAIN  PROGRAM ( S ) : 


CDJ01  -  AGGREGATOR  JOIN  FUNCTION 

RDCDFR  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
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3.10.9  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 
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DATA  AGGREGATORS  Include  File  Description 


FILE  NAME:  AGGMSG 

PURPOSE:  AGGREGATOR  INPUT  MESSAGE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  THE  FORMAT  OF  THE  INPUT  MESSAGE  FOR  THE 
CDMP  AGGREGATORS 


DESCRIPTION  : - 


AGGREGATOR  INPUT  MESSAGE  FORMAT 
NIS  -  NOT  IN  SET 
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DATA  AGGREGATORS  Include  File  Description 


FILE  NAME:  APL 

PURPOSE:  JOIN  QUERY  ATTRIBUTE  PAIR  LIST 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 


CONTAINS  INFORMATION  ABOUT  THE  JOIN 
ATTRIBUTES  FOR  NDML  SUBTRANSACTIONS 
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DATA  AGGREGATORS  Include  File  Description 


FILE  NAME:  CHKCDM 

PURPOSE:  IISS  CDMP  CHECK  STATUS  CODES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  STATUS  CODES  FOR  THE 
CDMP  MODULES 
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DATA  AGGREGATORS  Include  File  Description 


FIDE  NAME:  ERRCDM 

PURPOSE:  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  ERROR  CODES  USED  BY  CDMP  * 

MODULES  FOR  ERROR  HANDLING  * 
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DATA  AGGREGATORS  Include  File  Description 


FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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DATA  AGGREGATORS  Include  File  Description 


FILE  NAME:  JQGTBL 

PURPOSE:  JOIN  QUERY  GRAPH  TELLS  HOW  TO  CONNECT 

SUBTRANSACTIONS 
LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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DATA  AGGREGATORS  Include  File  Description 


FILE  NAME:  RFTAB2 

PURPOSE:  THE  RESULT  FIELD  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  CONCEPTUAL  SCHEMA  INFORMATION  ABOUT 
THE  RESULTS  OF  AN  NDML  REQUEST 


I 


1 

* 
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DATA  AGGREGATORS  Include  File  Description 


FILE  NAME:  RFTABLE 

PURPOSE:  THE  RESULT  FIELD  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  CONCEPTUAL  SCHEMA  INFORMATION  ABOUT 
THE  RESULTS  OF  AN  NDML  REQUEST 


THE  RESULT  FIELD  TABLE 

WHEN  CHANGING  THE  STRUCTURE  OF  THIS  TABLE 
BE  SURE  TO  CHANGE  THE  LAYOUT  IN  THE 
LINKAGE  SECTION  OF  THE  DRS  (CDS01) 

WHICH  WAS  COPIED  FROM  THIS. 
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DATA  AGGREGATORS  Include  File  Description 


FILE  NAME:  SRVRET 

PURPOSE:  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 


MODIFIED  11/2/83  TO  INCLUDE  RET-CODE-5 

MODIFIED  1/9/84  TO  INCREASE  ALL  ERROR  CODES  TO  PIC  X(5) 
AND  TO  ELIMINATE  ALPHA'S 

MODIFIED  1/26/84  TO  ADD  RET-CODE  FOR  GETUSR-NOT-SUCC 
SRV-SUCCESSFUL  ADDED  FOR  GENERIC  RETURN 
MODIFIED  2/7/84  TO  ADD  ERROR  CODES  FOR  ENTRY -NOT-FOUND 
MODIFIED  2/8/84  TO  ADD  WHTHST-NOT- SUCCESSFUL 
MODIFIED  2/20/84  TO  ADD  TSTMOD  NEW  CODES. 

MODIFIED  20  AUG  84  INITALIZE  ALL  LOCAL  VARAIBLES  TO 
SPACES  OR  0. 

MODIFIED  5/21/85  TO  ADD  RCL  AND  FILGEN  RETURN  CODES 
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DATA  AGGREGATORS  Include  File  Description 


FILE  NAME:  STDRESP 

PURPOSE:  WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 

LANGUAGE :  VAX - 1 1  COBOL 

DESCRIPTION: 


THE  STANDARD  'PROCESS  COMPLETE'  MESSAGE 
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3.10.10  Hierarchy  Chart 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  modules  mentioned  in  the  above  documentation. 
A  module  may  call  a  subroutine  several  times  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  modules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above. 

There  is  an  internal  paging  scheme  as  marked  by  the  numbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  limb  shows  where  that  the  tree  continues  on  the  page 
numbered  mentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
the  hierarchy  tree.  If  there  is  no  number  in  a  box,  the  routine 
either  makes  no  calls  or  is  an  external  routine. 
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3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4. 1  Introduction  and  Definitions 

"Testing"  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance,  and  a  sequence  of  test  steps  may  be 
specified.  "Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error  checking 
as  is  practical  and  possible  in  each  routine  should  be 
performed. 

4.2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs." 
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